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INTRODUCCIÓN 


En la mayoría de las áreas del conocimiento la experimentación es fundamen- 
tal para su avance. En particular, la ingeniería y las ciencias físicas dependen 
directamente de ella. Una simulación es un experimento realizado sobre un 
modelo de un sistema bajo estudio. Hoy en día es práctica usual de ingeniería 
realizar tales simulaciones sobre modelos de software con sofisticadas herra- 
mientas de cómputo. 

Desde el punto de vista pedagógico, la simulación es una tarea integra- 
dora de conocimientos y habilidades: para la construcción de los modelos a 
simular es necesario tener un dominio suficiente de los principios que rigen 
los fenómenos a simular; para seleccionar las condiciones de simulación es 
necesario conocer los rangos de validez de los modelos desarrollados; para di- 
señar los experimentos es necesario interpretar el contexto en el que operan 
los sistemas a ser simulados; para analizar los resultados es necesario dominar 
las herramientas matemáticas y de software. 

Este documento presenta el diseño y la implementación de un ambiente 
de simulación amplio y abierto. A la herramienta obtenida le he dado el nom- 
bre UNVirtualLab, en donde las dos primeras letras hacen alusión directa a la 
Universidad Nacional de Colombia, mi alma máter. Actualmente se gestiona 
su instalación como parte de los servicios de la Dirección Nacional de Inno- 
vación Académica de dicha universidad. 


¿Qué es UN VirtualLab? 


UN VirtualLab es un ambiente web de simulación de sistemas dinámicos 
enfocado al aprendizaje. En UNVirtualLab se pueden alojar plantas de expe- 
rimentación de dominios muy variados. En la versión inicial se han incorpo- 
rado modelos de Ingeniería, Biología y Economía para destacar su naturaleza 
multidominio. Estos ejemplos se han implementado a través de 14 plantas de 
experimentación, que en total tienen 961 variables internas y 4112 parámetros 
internos. Se ha elaborado una colección de 70 experimentos sugeridos sobre 
esas plantas. 
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Para actuar sobre esas plantas de experimentación se han diseñado 113 
controles agrupados en 40 grupos. Los resultados de la simulación se mues- 
tran en 48 figuras que grafican el comportamiento de 85 variables selecciona- 
das, que también son tabuladas. Adicionalmente se han diseñado un par de 
animaciones 2D para ilustrar el comportamiento de 5 variables. 

En mi opinión, este tipo de herramientas desarrolladas desde institucio- 
nes públicas deben promover la democratización del conocimiento. Por tanto, 
el acceso a los experimentos virtuales que allí se alojen no debe tener restric- 
ciones. Este convencimiento guió varias decisiones funcionales y de diseño, 
como por ejemplo: 


= Los experimentos que se alojan en UNVirtualLab pueden ser embebi- 
dos en ambientes de aprendizaje. Esto significa que un curso adminis- 
trado desde una plataforma como moodle puede utilizar internamente 
un experimento específico; para ello, puede usarse el formato SCORM o 
embeber un código HTML. 


= Los modelos de software de las plantas de experimentación se constru- 
yen con un lenguaje abierto (Modelica) y se diseñan, prueban, simulan 
y ajustan en una herramienta de software abierto (OpenModelica). 


= Tanto el código fuente de UNVirtualLab como el de los modelos que en 
él se alojan tienen licenciamiento libre (ver apéndice A). De esta forma, 
los usuarios pueden acceder al código de los modelos y modificarlos en 
OpenModelica. 


UNVirtualLab como un producto de investigación 


UN VirtualLab es el resultado de un esfuerzo que satisface los cinco crite- 
rios establecidos por la OECD para ser considerado como actividad de inves- 
tigación (ver [OEC15], numeral 2.7.): 


= Es novedoso, en tanto se ha obtenido un laboratorio virtual en el que se 
simplifica notablemente el desarrollo de nuevos experimentos virtuales, 
en comparación con alternativas preexistentes. El enfoque multidominio 
tambien es novedoso en el ámbito de las simulaciones web?. 


| Compárense los ejemplos presentados en la sección 5.2 con las especificaciones de UNVirtualLab dis- 
ponibles en la sección 6.1. 
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= Es creativo, en tanto articula de forma original dos ámbitos de software 
relativamente distantes: la simulación de sistemas dinámicos complejos, 
por una parte, y la interacción web, por otra?. 


= El proceso no estuvo exento de la incertidumbre propia del desarrollo 
de prototipos. UNVirtualLab es un prototipo que permite probar una 
estrategia específica para llevar a la web simulaciones de sistemas diná- 
micos basadas en modelos de escritorio. La incertidumbre queda explí- 
cita al destacar que la versión inicial de UNVirtualLab se reveló inope- 
rativa, lo que obligó a un cambio importante en la arquitectura interna 
del sistema?, 


= El proceso ha sido sistemático, en tanto se han empleado los procedi- 
mientos conocidos de desarrollo de software, tales como identificación 
de actores, requerimientos funcionales, casos de uso, etc.*. 


= El resulado es transferible, en tanto su desarrollo y resultado se han do- 
cumentado profusamente. El código fuente de UN VirtualLab y de los 
experimentos allí alojados tienen, además, licenciamiento libre, lo que 
asegura su reproducibilidad. 


El tipo de investigación al que nos referimos aquí corresponde al desarro- 
llo experimental (ver [OEC15], numeral 2.9.) que se dirije a la obtención de 
nuevos productos. En ese sentido, puede identificarse una cadena convencio- 
nal de generación de conocimiento, que inicia en el estudio de las Ecuaciones 
Diferenciales Algebraicas (investigación básica), continua con el desarrollo del 
lenguaje Modelica y el ambiente de simulación OpenModelica (investigación 
aplicada) y enlaza con el desarrollo de UNVirtualLab”. 


El documento 


Este documento se ha elaborado para explicar qué es UN VirtualLab, para 
qué puede utilizarse, cómo está diseñado, cómo se utiliza, y para presentar las 
plantas experimentales que se han incorporado. El documento se ha organiza- 
do en 14 capítulos agrupados en tres partes. El propósito de cada uno de estas 
partes y capítulos se explica a continuación: 


2El concepto de diseño utiliza una estrategia sencilla que se explica en la sección 6.1.2. 

3Los principales cambios se enumeran en el apéndice E. 

*Ampliamente documentados en el capítulo 6. 

SE] proceso es, por supuesto, mucho más complejo dado que debería incluirse toda la red de genera- 
ción de conocimiento que ha llevado al desarrollo de software, de la internet, del modelado y simulación 
de sistemas dinámicos, etc. Esta cadena simple solo pretende ilustrar la condición de UNVirtualLab como 
actividad de desarrollo expermiental. 
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Parte lI: aborda el problema de construcción de modelos y la simulación de 
los mismos en el ambiente OpenModelica. Esta compuesta por cuatro 


capítulos: 


Capítulo 1: 


Capítulo 2: 


Capítulo 3: 


Capítulo 4: 


está dedicado a presentar de forma comparativa una co- 
lección de técnicas de modelado de sistemas dinámicos. 
Tiene como propósito explicar las razones por las que se 
ha seleccionado la técnica de modelado orientado a obje- 
tos en general y el ambiente OpenModelica en particular 
para la construcción de los modelos que residen 
en UNVirtualLab. 


está orientado a mostrar las dificultades de la simulación 
numérica de Ecuaciones Diferenciales Algebraicas como las 
que resultan al emplear la técnica de modelado orientado a 
objetos. En este capítulo también se presentan los algorit- 
mos y estrategias usadas para abordar esas dificultades en 
los ambientes de simulación. 


está destinado a presentar las características principales del 
lenguaje de modelado Modelica. También se hace una breve 
presentación de la Modelica Standard Library. 


se utiliza para presentar la suite OpenModelica. El en- 
foque utilizado combina una explicación de los procedi- 
mientos internos de simulación con una presentación del 
potencial de las principales herramientas que conforman 
la suite. 


Parte II: dedicada a presentar el laboratorio virtual UNVirtualLab. Contiene 
tres capítulos: 
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Capítulo 5: 


Capítulo 6: 


está dedicado a mostrar el estado del arte relativo a los la- 
boratorios virtuales. Inicialmente se realiza una caracteri- 
zación y clasificación de los mismos, para luego evaluar su 
papel en el aprendizaje de la ingeniería. Este capítulo con- 
cluye con unas consideraciones generales útiles para el di- 
seño de UNVirtualLab. 


se presenta en detalle la arquitectura de UNVirtualLab. A 
partir de las especificaciones funcionales se presentan los 
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componentes, el modelo interno, algunos detalles de imple- 
mentación y la interfaz. Este capítulo se complementa con 
información que se encuentra en los apéndices B, C y D. 


Capítulo 7: este capítulo contiene los manuales de UNVirtualLab. Se 
han preparado tres manuales diferentes: 


Manual del administrador: el administrador es la persona 
encargada de la instalación y mantenimiento del siste- 
ma. Este manual explica cómo llevar a cabo esas tareas. 

Manual del modelador: el modelador es la persona encar- 
gada de construir las plantas de experimentación que se 
alojan en UNVirtualLab. Su rol va más allá de la cons- 
trucción del modelo que se simulará, pues también de- 
be reflexionar sobre el uso pedagógico de los modelos, y 
preparar la documentación asociada. Por esta razón, es- 
te manual presenta una guía para el diseño de las plantas 
de experimentación con un enfoque pedagógico. 

Manual del experimentador: el experimentador es el usua- 
rio final de UNVirtualLab. En este manual se explica el 
uso de la interfaz gráfica disponible. Esta explicación se 
complementa con un conjunto de videos disponibles en 
la implementación web de UN VirtualLab. 


Parte III: se presentan los modelos disponibles en la instalación web de 
UN VirtualLab a la fecha de elaboración de este documento. El conte- 
nido de cada capítulo es la misma documentación que está disponible 
en la implementación web para cada una de las plantas de experimen- 
tación. Los capítulos que aparecen en esta parte tienen todos la misma 
estructura: se presenta una explicación teórica de los modelos subya- 
centes, una descripción de cada planta de experimentación, un listado 
de experimentos sugeridos y una breve explicación de la estrategia de 
implementación. Las plantas de experimentación se han agrupado en 7 
capítulos cuyos modelos corresponden a: 


Capítulo 8: el modelo básico de un motor eléctrico DC acoplado a una 
carga mecánica. Este modelo es el “Hola Mundo' en el mo- 
delado orientado a objetos, y se incluye en los instaladores 
de UNVirtualLab. 
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Capítulo 9: un modelo del calentamiento de cables aéreos en líneas de 
transmisión de energía eléctrica. El modelo incorpora pro- 
blemas eléctricos, térmicos y mecánicos. Este modelo tiene 
unas ecuaciones algebraicas implícitas, que son resueltas por 
OpenModelica de forma transparente para el modelador. 


Capítulo 10: un grupo de modelos de propagación de enfermedades. Es- 
tos modelos están basados en la compilación e implementa- 
ción desarrollada en [Cam12]. 


Capítulo 11: un modelo del tránsito de estudiantes a través de un plan de 
estudios. Este es un modelo original presentado en [Dua13] 
como parte de las actividades desarrolladas en la Vicedeca- 
natura Académica de la Facultad de Ingeniería en la Univer- 
sidad Nacional de Colombia. 


Capítulo 12: un modelo de una central de generación hidroeléctrica que 
emplea la librería PoverSystems'. El modelo combina sis- 
temas hidráulicos, mecánicos, eléctricos y de control. La plan- 
ta utilizada incluye un lazo de control de frecuencia con un 
controlador PL. 


Capítulo 13: un modelo de la evolución del mundo propuesto por 
[MIM*74] y basado en dinámica de sistemas. La planta de 
experimentación es una adaptación simple de la librería desa- 
rrollada por Cellier en [Cel08]. 


Capítulo 14: un modelo de la técnica de identificación algebraica pro- 
puesto por Sira. El ejemplo seleccionado es el más sencillo 
que aparece en [SRGRCRTI]J14]: la identificación de una ma- 
sa sobre la que se ejerce una fuerza. 


Los estilos de redacción utilizados a lo largo del documento son variados. 
Los capítulos 1 a 4 se han redactado a manera de Texto Guía, y pueden ser 
utilizados en un módulo de algún curso de posgrado dedicado al modelado 
orientado a objetos. Estos capítulos presuponen que el lector está familiariza- 
do con los conceptos de análisis y modelado de sistemas dinámicos, métodos 
numéricos de solución de ecuaciones, métodos numéricos de integración y 
simulación, ecuaciones diferenciales ordinarias y programación orientada a 
objetos. El capítulo 5 es un estado del arte, y como tal se ha redactado. Los 


6 [link:1]. 
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capítulos 6 y 7 tienen el estilo de reportes técnicos y manuales de usuario res- 
pectivamente. Por su parte, los capítulos 8 a 14 tienen una combinación de 
estilos: texto guía para la presentación de los modelos y reporte técnico para 
la presentación de las plantas y la explicación de la implementación. 


Oscar Duarte 
Departamento de Ingeniería Eléctrica y Electrónica 
Universidad Nacional de Colombia 
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Parte I 


Modelado y simulación con 
OpenModelica 
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MODELADO DE SISTEMAS DINÁMICOS 


En este capítulo se comparan algunas técnicas de modelado de sistemas 
dinámicos con el propósito de presentar las razones por las que se ha opta- 
do por una de ellas, el modelado orientado a objetos, para el desarrollo de los 
modelos alojados en UNVirtualLab. Las alternativas comparadas son: técnicas 
analíticas específicas de cada dominio (sección 1.2.1), técnicas de espacio de 
estado (sección 1.2.2), técnicas variacionales (sección 1.2.3), técnicas de dia- 
gramas de bloques (sección 1.2.4), grafos de enlace de potencia (sección 1.2.5) 
y modelado orientado a objetos (sección 1.2.6). Como preámbulo, en la sec- 
ción 1.1 se presentan algunos elementos conceptuales básicos asociados a las 
tareas de modelado y simulación. La comparación de las técnicas se resume 
en la sección 1.3, mientras que en la sección 1.4 se justifica la elección de la 
técnica de modelado orientado a objetos. 


1.1 SISTEMAS, MODELOS, SIMULACIÓN 


En el contexto del estudio de los sistemas dinámicos es usual adoptar una de- 
finición muy amplia del término sistema como por ejemplo: “el objeto o colec- 
ción de objetos cuyas propiedades queremos estudiar” ([LG94]) o, de forma 
más escueta, “aquello que se desea estudiar”. ([Dua05]). Estas amplias defini- 
ciones permiten abarcar objetos de estudio de disciplinas tan variadas como 
la biología, la astronomía, la mecánica, etc. 

El énfasis de esas definiciones está en el propósito de estudiar el sistema. 
Para hacerlo, construimos representaciones de ese sistema que reciben el nom- 
bre de modelos. En términos generales, un modelo debe facilitarnos estudiar 
y, por tanto, entender el sistema. 

Algunos de los modelos están construidos de tal manera que permiten 
realizar experimentos sobre ellos. El objetivo es experimentar sobre el mo- 
delo, en lugar de hacerlo sobre el sistema. Tales experimentos se denominan 
simulaciones. Si el modelo representa adecuadamente al sistema, entonces los 
resultados de una simulación reflejarán el comportamiento que habría tenido 
el sistema si el experimento se hubiese realizado directamente sobre él. 

Hay una amplia variedad de tipos de modelo: gráficos, mentales, verbales, 
matemáticos, de software etc. En este capítulo nos interesa abordar el proble- 
ma de construir modelos que permitan alimentar un laboratorio virtual, es 
decir, modelos matemáticos a partir de los cuales se puedan obtener modelos de 
software para realizar simulaciones en computador del sistema bajo estudio. 
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Un mismo sistema puede representarse de formas muy variadas; en otras 
palabras, podemos construir modelos diferentes de un mismo sistema. Para 
juzgar cuál de los modelos disponibles de un cierto sistema es el adecuado, 
deben usarse los criterios de utilidad y simplicidad del modelo. Se debe se- 
leccionar un modelo que cumpla las funciones que esperamos de él, y entre 
todos los modelos que lo hagan, el más adecuado será el más sencillo. No exis- 
te, entonces, el modelo de un sistema dado. Por el contrario, la elección del 
modelo está condicionada por el tipo de estudio que querramos realizar sobre 
ese sistema!. El criterio de utilidad tiene al menos dos dimensiones: 


= El modelo debe ser capaz de reflejar de forma adecuada los fenómenos 
que se quieren estudiar. 


= El modelo debe poder utilizarse con las herramientas de experimenta- 
ción (de simulación) disponibles. 


Por esta razón, las técnicas de construcción de modelos están estrecha- 
mente relacionadas con las herramientas de simulación disponibles. La so- 
fisticación de las unas van de la mano de las otras. En el caso particular de 
los modelos de software, la evolución de las técnicas de construcción ha te- 
nido además otros condicionantes, tales como la evolución del hardware y el 
desarrollo de métodos numéricos computacionales adecuados para la simula- 
ción de sistemas cada vez más complejos (véase [OC95]). 


1.1.1 Construcción de modelos matemáticos 


Es usual clasificar los modelos matemáticos según la estrategia usada para su 
construcción. En [OR94] se distinguen dos casos: 


Modelos Empíricos: son modelos obtenidos como ajuste de funciones mate- 
máticas, generalmente simples, a partir de información sobre el com- 
portamiento externo del modelo. También se denominan modelos de 
entrada-salida o de caja negra. El procedimiento empleado para la ob- 
tención de estos modelos se denomina Identificación de sistemas. 


lLjung lo expresa de forma diáfana: “El sistema de la vida real es un objeto de una clase diferente a 
nuestros modelos matemáticos. En cierto sentido, existe una pantalla impenetrable pero transparente entre 
nuestro mundo de las descripciones matemáticas y el mundo real. Podemos mirar a través de esa ventana 
y comparar ciertos aspectos del sistema físico con su descripción matemática, pero no podremos nunca 
establecer ninguna conexión exacta entre ellos. La pregunta de si la naturaleza es susceptible de ser descri- 
ta matemáticamente tiene algunos aspectos filosóficos profundos, y en términos prácticos debemos tener 
una visión más pragmática sobre los modelos. Nuestra aceptación de los modelos debe estar guiada por su 
“utilidad” en lugar de su “verdad”[Lju87]. 
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Modelos Teóricos: son modelos obtenidos a partir del conocimiento previo 
sobre los fenómenos que se presentan en el sistema y que son relevantes 
para el estudio que se desea realizar, así como de las leyes que los rigen?. 
Debido a que estos modelos se apoyan en una descripción de lo que está 
sucediendo dentro del sistema, también se denominan modelos inter- 
nos o de caja blanca. El procedimiento empleado para la obtención de 
estos modelos se denomina Modelado teórico de sistemas o simplemente 
Modelado de sistemas. 


Por supuesto, también es posible combinar las estrategias de identifica- 
ción y modelado: se pueden utilizar las técnicas de identificación para encon- 
trar los valores numéricos más adecuados para los parámetros de un modelo 
teórico; así mismo, se puede emplear el conocimiento teórico previo que se 
tenga del sistema para seleccionar la función matemática que se debe ajustar 
en una identificación. 

El enfoque usual de los laboratorios virtuales (véase capítulo 5) hace que 
los modelos empíricos no sean los más adecuados. Por ejemplo, UN VirtualLab 
tiene un enfoque hacia el aprendizaje (véase capítulo 6) y la descripción inter- 
na de los sistemas es fundamental en el proceso de aprendizaje; por tanto, es 
preferible emplear modelos internos”. 

En [OR94] se propone un procedimiento general para el desarrollo de 
modelos teóricos que incluye una iteración sobre cuatro fases: 


Mád.1. Definición del problema: en esta fase se definen aspectos generales ta- 
les como el propósito del modelo, los aspectos relevantes a modelar, 
el nivel de complejidad, el grado de conocimiento de los fenómenos 
involucrados, los recursos que se pueden emplear en la tarea de 
modelado, etc. 


Md.2. Formulación del modelo: en esta fase se construyen las relaciones ma- 
temáticas que describen el fenómeno. 


Md.3. Estimación de parámetros: en esta fase se encuentran los valores nu- 
méricos de los parámetros que aparecen en el modelo matemático. Es 


2En [LG94] a los modelos de este tipo se les denomina modelos físicos. En este documento se ha pre- 
ferido el término teórico, porque los modelos sociales y económicos construidos a partir de las leyes de sus 
respectivos dominios, difícilmente pueden calificarse como físicos. 

3Los métodos de identificación también pueden ser objeto de estudio en un laboratorio virtual. Por 
ejemplo, en el capítulo 14 se presenta un modelo interno de un proceso de identificación de sistemas. 
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usual que se requiera algún tipo de experimentación física sobre la plan- 
ta, o al menos el registro de su comportamiento natural para encontrar 
estos valores. 


Md.4. Validación del modelo: en esta fase se evalúa el desempeño del modelo 
para determinar si es lo suficientemente útil para nuestras necesidades. 
El Rango de validez del modelo es el conjunto de condiciones dentro de 
las cuales el modelo satisface esas necesidades. 


En las siguientes secciones, el foco de atención se centra en la segunda de 
estas fases: la formulación del modelo; específicamente, en la formulación 
de modelos matemáticos a partir de los cuales se puedan obtener modelos de 
software para ser simulados en computador. En la sección 1.2 se presentan las 
técnicas más conocidas, cuyas características se comparan en la sección 1.3, 
mientras en la sección 1.4 se explica por qué se ha seleccionado la técnicas de 
modelado orientado a objetos para la construcción de los modelos simulados 
en UNVirtualLab. 


1.2 TÉCNICAS DE MODELADO MATEMÁTICO CON FINES DE 
SIMULACIÓN 


A continuación se presenta un conjunto de técnicas de construcción de mo- 
delos matemáticos mediante las cuales se pueden obtener ecuaciones suscep- 
tibles de ser simuladas por computador. El énfasis está en la obtención de mo- 
delos dinámicos, es decir, modelos cuyo comportamiento actual depende del 
pasado. No es de extrañar, entonces, que las ecuaciones resultantes incluyan 
derivadas, integrales o diferencias finitas. 

Algunas de las técnicas son más susceptibles de generalizar y sistematizar 
que otras. Las técnicas que se presentan en esta sección se han organizado de 
menor a mayor grado de sistematización. La presentación consiste en una so- 
mera explicación de los principios de cada una de las técnicas y no pretende 
ser un tratado sobre ninguna de ellas. Los conceptos se ilustran con ejemplos 
de construcción de modelos sobre un mismo sistema, que corresponde al cir- 
cuito lineal de la figura 1.1 con Li¡ = L2 = 1H, C = 1F, estimulado con un 
escalón unitario E(t) = pt). 


1.2.1 Técnicas analíticas especificas de cada dominio 


En contexto de este documento, se utiliza el término dominio para referirse a 
un área delimitada del conocimiento, tal como la biología, la electricidad, la 
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termodinámica, etc. Al interior de cada uno de estos dominios se han desarro- 
llado técnicas específicas para la construcción de los modelos matemáticos de 
los fenómenos que allí se estudia, de forma más o menos aislada respecto a 
otros dominios. En las aplicaciones típicas de control, se analizan modelos de 
los dominios eléctrico, magnético, mecánico rotacional, mecánico traslacio- 
nal, fluidos, intercambios de calor e intercambios de masa?. 


Ly 


Figura 1.1 Circuito de los ejemplos de modelado mediante diversas técnicas 


En el desarrollo de modelos específicos de cada dominio la estrategia bá- 
sica es la misma: 


1. Descomponer (abstractamente) el sistema en subsistemas más simples. 


2. Obtener los modelos de los subsistemas mediante la aplicación de leyes 
o principios elementales. 


3. Buscar las relaciones que existen entre los modelos obtenidos (de nue- 
vo, mediante la aplicación de leyes elementales) e interconectarlos para 
obtener el modelo del sistema original. 


Al interior de cada dominio se han desarrollado técnicas específicas que 
facilitan la obtención de los modelos analíticos. La aplicabilidad de esas técni- 
cas está, por tanto, restringida a su propio dominio. Ejemplos de estas técnicas 
especificas son: análisis de mallas y nodos para circuitos eléctricos, análisis de 
cuerpos libres para sistemas mecánicos, técnicas basadas en el volumen de 
control para fenómenos termodinámicos, entre otros casos. 

La similitud entre las expresiones matemáticas que aparecen en diferentes 
dominios, como modelos explicativos de fenómenos distintos, ha permitido la 


“Véanse, por ejemplo el capítulo 5 de [LG94], o los capítulos 3 y 5 de [Wel00]. 
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aparición de analogías tales como: el modelado de fenómenos magnéticos co- 
mo si fuesen circuitos eléctricos resitivos, el modelado de fenómenos de trans- 
ferencia de calor como circuitos eléctricos resistivos y capacitivos, etc. Estas 
similitudes también han permitido la aparición de técnicas generalizadas de 
modelado. Se trata de técnicas que utilizan variables generalizadas en conjun- 
to con métodos de redes y grafos, que permiten entender los fenómenos de 
cada dominio (y sus técnicas de modelado) como casos particulares de fenó- 
menos (y técnicas) más generales”. Sin embargo, estas técnicas generalizadas 
siguen siendo específicas de un dominio en el sentido de que son aplicables a 
cada dominio por separado. 

Las técnicas de modelado básicas para cada dominio suelen tener un en- 
foque analítico, queriendo decir con esto que los modelos matemáticos suelen 
ser desarrollados con el propósito de facilitar el análisis de los fenómenos estu- 
diados. A medida que los fenómenos van ganando complejidad, el análisis se 
dificulta y por tanto es necesario utilizar modelos enfocados hacia la simula- 
ción numérica. Para ilustrar la diferencia entre estos dos enfoques, considere- 
mos el modelado de circuitos eléctricos mediante dos técnicas, que se ilustran 
en los ejemplos 1.1 y 1.2: 


Análisis de mallas: esta es una de las técnicas elementales de modelado de cir- 
cuitos!. El modelador debe identificar las mallas existentes en el circuito 
y asignar una corriente a cada una de ellas. Las ecuaciones se construyen 
a partir de la aplicación de la ley de tensiones de Kirchhoff, en conjunto 
con las caracterísiticas tensión-corriente de cada uno de los elementos 
del circuito. 


Para circuitos simples, el procedimiento genera un conjunto reducido 
de ecuaciones susceptibles de ser analizadas manualmente, razón por 
la cual es la técnica favorita de los modeladores nóveles. Sin embargo, 
cuando la complejidad del circuito aumenta, aparecen algunas 
dificultades: 


= Las fuentes de corriente, tanto dependientes como independientes, 
obligan a modificar el procedimiento básico. 


= Si el grafo del circuito no es plano, el conjunto resultante de ecua- 
ciones es redundante. 


Véase, por ejemplo, el texto clásico de Wellstead [Wel79], ahora disponible en formato digital abierto: 
[Wel00]. 

SLa explicación se puede encontrar en cualquier texto básico de teoría de circuitos, como por ejemplo 
en [HDKO7]. 
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= Si el circuito contiene elementos controlados por tensión, es nece- 
sario modificar el procedimiento básico. 


= Siel número de mallas es grande, el análisis manual puede ser difícil 
o ineficiente, cuando no imposible. 


Tableu analysis: esta es una técnica orientada a la obtención de modelos de 
circuitos para ser simulados en computador (véase [CDK87]). El circuito 
debe representarse por un digrafo, a partir del cual se escriben de forma 
sistemática: 1) un conjunto de ecuaciones provenientes de la aplicación 
de la ley de corrientes de Kirchhoff, y 2) las ecuaciones de cada rama a 
parir de las relaciones tensión-corriente de cada elemento. 


Con esta técnica, el conjunto de ecuaciones resultante es mayor que al 
aplicar el análisis de mallas. Además, está formado por una mezcla de 
ecuaciones diferenciales y ecuaciones algebraicas. No obstante, estas ecua- 
ciones están organizadas de tal manera que se pueden aplicar algorit- 
mos generales de solución y simulación previamente implementados en 
software”. 


Ejemplo 1.1: Modelado analítico con técnicas específicas 
de un dominio. 


El sistema de la figura 1.1 corresponde a un circuito dinámico lineal. Como 
tal, puede modelarse empleando la técnica de análisis en el dominio de la fre- 
cuencia compleja: los elementos dinámicos se representan por sus impedan- 
cias complejas, y posteriormente se realiza un análisis convencional de mallas. 


Los inductores se representan por la impedancia compleja s.L, y los capacitores 
por 1/sC, en donde s es la variable compleja. Esta técnica de análisis no es otra 
cosa que la utilización directa de la transformada de Laplace. En este ejemplo 
suponemos que las condiciones iniciales de los elementos dinámicos son cero, 
es decir, que no hay energía almacenada en el instante de tiempo + = 0. En 
estas condiciones, el sistema se puede representar por el siguiente circuito: 


7Los simuladores de circuitos eléctricos más populares emplean métodos de Newton para solución 
de ecuaciones algebraicas, y métodos de Euler para simulación de sistemas dinámicos. No obstante, en la 
sección 2.6 se muestra las dificultades que este último método puede tener aún en casos simples. 
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Al emplear un análisis convencional de mallas se obtienen dos ecuaciones: 


sLaIx(5) + 6 (1a(5) — Eo(9)) = Vís) 
1 
50 


(1.1) 
(L2(s) — 1 (s)) + sLoL>(s) =0 


Podemos despejar 1; (s) de la segunda ecuación y remplazar en la primera: 


1, (s) = (s?L2C + 1) Lx(s) 
V(s) = (sa + 7) (s*L2C +1) L(s) — ml 
V(s) = (s"L¡L2C + sLi + sLo) (5) (1.2) 
A O a rr 
2 
h(s)= ET sLa (s) 


Para obtener los valores de las corrientes en el tiempo, usamos los valores L1 = 
L2 = 1H,C = 1F, E(t) = pt), aplicamos fracciones parciales y luego 
calculamos la transformada inversa de Laplace para t > 0: 


2 
só +1 1 
1 (s) = %4- 
1(s) s(s2 +2) s (13) 
El)= dl 1 : 
cid —s(s24+2)8 
ee 0,5 y2 
DAS "yY282+2 014) 
0,5 0,5 y2 
L(s) = 52 v2 5? +2 
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¿1(t) = 0,5t + e (V2t) 
v2 
05 (1.5) 
io(t) = 0,54 — — sin (V2t 
También es posible calcular la corriente en el capacitor, ¿3(t) 
1 
i3(t) = i1(€) — i2(t) = — sin (V2t) (1.6) 


v2 
Las tres corrientes ¿1 (4), i2(t), i3(t) se han graficado utilizando Scilab (ver 
[Ent16]): 


Corrientes en el circuito LLC (A vs s) 


Ejemplo 1.2: Modelado para simulación con técnicas de un dominio. 


Considérese el circuito de la figura 1.1. Para aplicar la técnica del tableau, mar- 
camos todas las corrientes y tensiones del circuito y construimos el dígrafo. 


Circuito Digrafo 
ES 
Li 
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A partir del dígrafo construimos la matriz de incidencia reducida, que permite 
escribir de forma compacta las ecuaciones de corrientes de Kirchhoff: 


t1 0 

0 ¿E A E il [0 
a=(, -1 -1 a la ea 

14 0 


Las ecuaciones de rama se construyen a partir de las relaciones tensión 
corriente de cada elemento: 


dix di y duz 
v1 a va 24 13 e VA (1.8) 
Las ecuaciones del circuito son entonces 
Mov + Miv + Noi + Ni = us (1.9) 
en donde 
00.00 1000 Uv 
[0.0.0.0 01.00 O [fe 
M=lo0:0000 1" lo 00011 e= (1) 
00.00 00.0 1 Va 
(1.10) 
—l1 0 0 0 00 0 0 
0 —mL3 0 0 [00 0.0 
No=| 7 0- Ny M= 0 0:10 
0 0 0 0 00 0 0 
(1.10) 
t1 0 
i= 12 u 0 
ás s 10 
la E 


lo que permite escribir el sistema de ecuaciones matriciales (el tableau) 
Ai=0 
—ATe-v=0 (1.12) 
Mov + Myv + Noi + Nji— us =0 


La ecuación 1.12 es de la forma g(t, y, y) = 0, y por tanto puede ser simulada 
con el algoritmo dassl. Se ha utilizado la implementación disponible en Scilab 
para la simulación, con L¡ = L2 =1H,C =1F, E = 1V. La figura siguiente 
muestra el resultado para 1, ía e i3: 
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Corrientes en el circuito LLC (A vs s) 


1.2.2 Técnicas de espacio de estado 


Los modelos en espacio de estado, o simplemente modelos de estado, se ca- 
racterizan por tener la siguiente estructura matemática: 


x(1) = f(x(1), u(t), £) 
y(t) = g(x(t), u(t), t) 


en donde u(t), y(t) son vectores que contienen las variables de entrada y de 
salida del sistema, respectivamente. Por su parte, x(t) es un vector de varia- 
bles de estado que pueden asimilarse a variables auxiliares seleccionadas para 
representar la dinámica del sistema en la forma dada por la ecuación 1.13. 
Son varias las ventajas de lograr una representación de estado. Desde el 
punto de vista de la simulación, la ecuación diferencial x(t) = f(x(t), u(t), t) 
tiene la forma adecuada para ser simulada por métodos numéricos. Desde el 
punto de vista analítico, existe una enorme cantidad de resultados matemá- 
ticos y procedimientos bien conocidos para el análisis, la identificación y el 
control de modelos de estado, en especial para aquellos que además son linea- 
les e invariantes en el tiempo y que, por tanto, pueden representarse como?: 


(1.13) 


x(t) = Ax(t) + Bu(t) 


y(t) = Cx(t) + Du(t) (1.14) 


SVéanse por ejemplo [Che95], [Che93], [OM96], [Kat05]. 
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Las variables de estado pueden carecer de sentido físico directo. No obs- 
tante, para la construcción del modelo matemático es conveniente destacar 
que las variables de estado son las portadoras de la información sobre la 
dinámica del sistema. Debido a que en los sistemas físicos esta dinámica 
se relaciona con la acumulación de energía, una buena idea consiste en se- 
leccionar como variables de estado candidatas a las variables asociadas con 
este fenómeno. 

Otra de las grandes ventajas de los modelos de estado consiste en la simi- 
litud matemática con la que se pueden representar fenómenos donde la varia- 
ble tiempo se representa de forma discreta: k = 0, 1,2, - - -. En estos casos, el 
modelo general resulta ser 


(1.15) 
y() = g(x(k), u(k), k) 
mientras el modelo lineal e invariante en el tiempo corresponde a 
k +1) = Ax(k) + Bu(k 
x(h +1) = Ax(k) + Bu(b) 26 
y(k) = Cx(k) + Du(k) 


Ejemplo 1.3: Modelado en espacio de estado. 


Para el circuito de la figura 1.1 los fenómenos de acumulación de energía suce- 
den en los inductores en forma de energía magnética y en el capacitor en forma 
de energía eléctrica. Para los inductores, la variable directamente asociada con 
la acumulación de energía (1) es la corriente (w = Li?/2), mientras que pa- 
ra el capacitor es la tensión (w = Cu? /2). Por esta razón, seleccionamos las 
siguientes variables de estado: 


11 =1ÚL, 12 =1Lo 13 = Ue (1.17) 
La dinámica del circuito puede entonces escribirse como 


E-— Li¡ti — lg = 0 
13 — Laza =0 (1.18) 
—11 +12+Cx3=0 
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Al despejar las derivadas de las variables de estado se obtiene: 


== —E 
T1 Li L3 + Li 
Ñ 1 
Ta = ia (1.19) 
. 1 1 
13= AT1=>5 
3= ¿4 qa 
Que en forma matricial es 
L1 0 0 —1/L; XL1 1/£; 
1 0 0 1/La za | + 0 E (1.20) 
3 1/C -1/C 0 XL3 0 
Tomando y = [i1 ¿2 ¿3]” como la salida del sistema, entonces 
Yi 1 0 0 21 
yl|=|0 1 0 29 (1.21) 
Y3 1-10 13 


las ecuaciones 1.20 y 1.21 tienen la forma general de la ecuación 1.14. Además, 
para el caso en que L; = La =1H C = 1F, la matriz A resulta ser: 


0 0 -—1 
A=|0 0. 1 (1.22) 
1-1 0 
cuyos valores propios son e, = 0, ez = j v2, ez = —jv2. En tales condi- 


ciones, podemos asegurar (véanse, por ejemplo [Che95, Dua05]) que las res- 
puestas de entrada cero del sistema serán de la forma 


Tec(t) = at + az sin (V2+ az) (1.23) 


que, por otra parte, concuerda con el resultado analítico obtenido en las ecua- 
ciones 1.5 y 1.6. 


Las ecuaciones 1.20 y 1.21 se han simulado en Scilab para L¡ = L2 = 1H, 
C = 1F, E = p(t). Para ello se utilizó la instrucción ode, que implementa 
por defecto el método de simulación de Adams para Ecuaciones Diferenciales 
Ordinarias. La siguiente figura muestra el resultado de la simulación numé- 
rica para las corrientes del circuito, que coincide con las simulaciones de los 
ejemplos 1.1 y 1.2: 
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Corrientes en el circuito LLC (A vs s). Modelo de espacio de estado 


e 11 


e 12 


sl 13 


1.2.3 Técnicas variacionales 


Ciertos fenómenos físicos pueden explicarse como la condición mediante la 
cual la naturaleza minimiza una cantidad específica. El principio de Hamilton 
de mínima acción es quizás el ejemplo más conocido. Este hecho permite for- 
mular el problema de modelado matemático como la búsqueda de la función 
matemática que minimiza esa cantidad específica, expresada como un funcio- 
nal. Debido a que los problemas de minimización de funcionales son objeto de 
estudio del cálculo de variaciones, estas técnicas de modelado se denominan 
de forma genérica técnicas variacionales. 

Un funcional es una función que opera sobre funciones, asignándole un 
número real a cada función. En particular, para una función genérica y(t) po- 
demos definir el funcional J : U € V > R así: 


ti 
109 =f 1030) de (1.24) 
to 
en donde V es el conjunto de funciones diferenciables con continuidad 
C*([to,t1]). En esas condiciones, la función y(t) que minimiza el funcional 
J debe satisfacer las condiciones de Euler (véanse [Gal03, Vil09, San03]): 


OL Ñ d OL 


dy (t, y(t), y(t)) — de 97 (y, y(t),y(t)) =0 Vte (to,t1) (1.25) 


En términos generales, las técnicas variacionales de modelado consisten 
en construir el funcional que debe minimizarse y posteriormente aplicar 
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las condiciones de Euler para hallar las ecuaciones reales del fenómeno. Las 
técnicas variacionales buscan representar la dinámica del sistema a partir de 
un conjunto de N coordenadas generalizadas independientes q1(t), qa(t),---, 
an(t), acompañadas de un conjunto de N variables dinámicas, que pueden 
ser las velocidades generalizadas, q1(t), qa(t), - -- gw (t) o los momentum gene- 
ralizados pi(t), pa(t), -- - py (t). El adjetivo generalizado hace referencia a la 
aplicación del método en fenómenos distintos a los de traslación mecánica, 
en los que fueron inicialmente utilizados. 

Para la descripción de una gran variedad de fenómenos físicos en los que 
una partícula se mueve en un campo conservativo, el funcional que se utiliza 
es el lagrangiano: 


L(q,4) =T(9,4) - V(q) (1.26) 


en donde T(q,4) y V(q) representan las energías cinética y potencial 
respectivamente. 

Sin embargo, cuando la partícula está en presencia de campos no conser- 
vativos, es necesario modificar el lagrangiano. En [OLNSR98] se propone el 
siguiente lagrangiano que incluye acciones de control 4 y las perturbaciones 


O:: 
t 
en donde F(4) = 3) j kg es la función de disipación de Rayleigh y 


Vwc(q,t) =-(U+9Q) q (1.28) 


Al incorporar 1.26, 1.27 y 1.28 como la función L en la ecuación 1.25, se 
obtiene una versión de las ecuaciones de Euler-Lagrange: 


d (5) OL OF 
(1.29) 


alo . = a 


Si, además, el sistema está sujeto a restricciones, entonces puede usarse la 
técnica de los multiplicadores de Lagrange para minimizar el funcional. Por 
ejemplo, en [SJK03] se utiliza una estrategia desarrollada para el análisis de 
circuitos eléctricos, donde las leyes de Kirchhoff se expresan como restriccio- 
nes. El lagrangiano utilizado es la diferencia entre la coenergía magnética y la 
energía de campo eléctrico: 
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L(q, 4) = Tmla, q) = Vela) (1.30) 
y la ecuación 1.29 se transforma en: 
d (OL OL OF 
1160 1=ÑÚl0, 0 == 10) +A 1.31 
7 apa0) 0 GEO HADAS 3) 


en donde q es el vector de corrientes del circuito, A es el multiplicador de La- 
grange, y 
A(g (4) =0 (1.32) 


es la forma matricial de la aplicación de la Ley de Corrientes de Kirchhoff en 
los nodos del circuito. 


Ejemplo 1.4: Modelado basado en el lagrangiano. 


Con respecto al circuito de la figura 1.1, podemos aplicar el método variacional 
basado en el lagrangiano. Para ello definimos las coordenadas q: 


¿= lá de dal? = liz, ¿1, ¿e? (1.33) 
La coenergía magnética es 


_Ld. Lg 


: Las ¿0 
Tulq, 4) = ¿Lniz, + ¿Laiz, == a (1.34) 
La energía de campo eléctrico es 
43 
== 1.35 
Vela) = 326 (1.35) 
Al reemplazar en 1.26, se obtiene: 
a Ladi , Load 43 
= 1.36 
A E E (1.36) 
Para escribir la ecuación 1.31 calculamos primero: 
OL 
—"(a.4d=0 
a 0D 
OL OL 
lando=¿E(a9=0 1.37 
SA AC (1.37) 
OL js 43 
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También calculamos: 


ÓL A : d óL , a 
In d) = Lig 0 2D = Lig 
oL,. Mecca y Ml do 
9 2D = SS q) = Lod2 .. mn (350) = 3 at 04 (4,4) = Lada (1.38) 
OL z d ÓóL , 
de De 0 LD= 


Como no hay disipación en el circuito, entonces F(q) = 0. Por otra parte, no 
hay perturbaciones y solo aparece una fuerza generalizada, dada por la fuente 
de tensión: 


Us = E Uy, =0 Las =0 (1.39) 
mientras que las restricciones están dadas por las leyes de Kirchhoff: 
Lts tk=0 . -qd-d3=0 (1.40) 
La ecuación de restricciones 1.32 se define entonces con 
Adell =1 <= (1.41) 


y la ecuación 1.31 resulta ser: 


L141 0 0 1 E 
Lada | — 0 =-|0|+|-1A+]|0 (1.42) 
0 ¿9/0 0 == 0 


Es decir, las ecuaciones 1.31 y 1.32 se expresan mediante el siguiente sistema 
de ecuaciones: 


Li =A+E 

Laq2 = A 
da (1.43) 
q A 


di -d-d3=0 


Para eliminar A lo despejamos de la tercera ecuación, y el valor obtenido lo 
remplazamos en las dos primeras: 
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43 
=-=+E 
or 


Lao = (1.44) 


da -d-d3=0 


Si definimos 11 = (1, 12 = (2, 13 = 43/C el sistema se convierte en 


LiG1 


A 3 E 
li =-==+> 

> Li Li 
. 23 

A 1.45 

La 7 ( ) 
E L1 L2 
l3=A-=% 

2 O 


que en forma matricial resulta ser la misma ecuación 1.20: 


L1 0 0 —1/L1 21 1/L; 
xa | = 0 0 1/L xa l+ 0 E (1.46) 
3 1/C -1/C 0 L3 0 


1.2.4 Diagramas de bloques y diagramas de flujo de señal 


En [MB12] se clasifican las técnicas de modelado de sistemas dinámicos en 
dos tipos: 


= Técnicas de flujo de señal. 
= Técnicas de interacción física. 


Los diagramas de bloques y los diagramas de flujo de señal corresponden 
al primer tipo. La característica fundamental de esta técnica consiste en mo- 
delar la interacción del sistema con su entorno a través de señales. El sistema 
es estimulado por el entorno a través de señales de entrada, reacciona a ese 
estímulo y genera señales de salida. 

En general, si se denotan con y las señales de salida de un sistema y con u 
las de entrada, el modelo matemático del sistema será: 


y = Flu) (1.47) 
en donde F es un operador genérico. 
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Un aspecto para resaltar: la señal de salida del sistema es la misma sin 
importar qué elemento del entorno reciba esa señal. Empleando el lenguaje del 
análisis de circuitos, los modelos de flujo de señal son modelos de impedancias 
ideales: la impedancia vista por el sistema desde sus entradas es cero, mientras 
que la impedancia vista por el sistema desde sus salidas es infinita. 

¿El mundo físico se comporta así? La respuesta a esta pregunta no 
compete al modelado. En su lugar deberíamos formular otra más adecuada, 
como por ejemplo: ¿bajo qué condiciones un modelo de flujo de señal es útil? 
En particular, varios dispositivos de procesamiento de señales se diseñan con 
el propósito explícito de que su respuesta (su salida) no dependa del elemento 
que se conecte a sus salidas. En tales condiciones, un modelo de flujo de señal 
puede ser adecuado. El ejemplo 1.5 ilustra este aspecto de los modelos de 
flujo de señal. 

Si el modelo de un sistema dinámico es lineal e invariante en el tiempo, 
entonces la ecuación 1.47, con condiciones iniciales nulas, puede convertirse 
en: 

y(s) = E(s)u(s) (1.48) 


en donde F(s) es la función de transferencia del sistema, y los vectores u(s), 
y(s) son los vectores de las transformadas de Laplace de u(t), y(t). En estas 
circunstancias, además, es posible utilizar herramientas tales como el álgebra 
de bloques y la regla de Mason para analizar diagramas complejos (véanse 
[Che93, Dua05], por ejemplo). 


Ejemplo 1.5: Modelado con diagramas de bloques. 


Los resultados de los ejemplos 1.1, 1.2 y 1.3 nos permiten interpretar el com- 
portamiento del circuito de la figura 1.1 como un dispositivo que convierte 
una tensión constante E en señales eléctricas sinusoidales. En particular, la 
tensión entre los terminales del capacitor v, puede obtenerse a partir de 


E 
tlt)= 5 icl[t) +k (1.49) 
0 
1. es la misma ¿3 en la ecuación 1.6: 


ve(t) = -5 cos(V2) +k (1.50) 
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El valor de k se obtiene al evaluar la condición inicial: 


1 1 
vo(0) =0=-=5+k  k=> (1.51) 


Por lo tanto, la tensión entre los terminales del condensador esta dada por 


we(t) = ; (cos (V2t) + 1) (1.52) 


Se puede definir una función de transferencia para la salida v., empleando las 
ecuaciones de estado 1.20 y 1.21: 


x(t) = Ax(t) + Bu(t) 


1.53) 
y(t) = Cx(t) + Du(t) 
La función de transferencia se calcula como: 
F(s) =C(sI— A) B+D (1.54) 
Calculamos inicialmente: 
Ss 0 1/L; 1 1 
sI—A = 0 s  —1/L, der(sl—a)=8 (9. + 77+7 7) 
-1/C 1/C Ss LC LC 
(1.55) 
y por tanto: 
1 s+1/L2€C  1/LC  —s/Li 
(sI-A)? = 1/L2C— s*+1/Li¡C  s/Lo 
(ardor) ao aja 
(1.56) 
Al utilizar y = v. la matriz C debe ser C = [0 0 1] y por tanto: 
1/L¡C 
E(s) = Pa (1.57) 


2 1 1 
rr rta 
En estas condiciones, podemos visualizar el circuito de la figura 1.1 mediante 
el siguiente bloque 
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Se ha empleado la herramienta xcos (de scicos) para modelar este diagrama de 
bloques. El montaje en xcos y el resultado de la simulación son los siguientes: 


Diagrama Simulación 


TR 


Figura 1.2 Circuito de los ejemplos 1.5 y 1.7 


¿Qué sucede si ahora conectamos un resistor entre los terminales del capacitor, 
tal como muestra la figura 1.2? Para conocer la corriente que circula por el 
resistor podemos modelar este mediante ¿n = R/vp, e interconectar los dos 
sistemas como se muestra a continuación: 


ale 


Se ha graficado el resultado de la simulación (en azul) junto con el resulta- 
do de un análisis exacto del circuito (en rojo), para cuatro valores diferentes 
de R: 
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a) R = 100090 b) R = 1000 


— Simulación == Valor exacto — Simulación == Valor exacto 


6 4 
tiempo (s) tiempo (s) 


c) R= 100 dYR=10 


— Simulación Valor exacto — Simulación == Valor exacto 


6 4 
tiempo (s) tiempo (5) 


Puede observarse que para valores “grandes” de R el modelo de flujo de señal 
es bastante exacto, mientras que para valores “pequeños” de RR el error come- 
tido es inadmisible. Al variar R, se varía el valor de la impedancia vista por 
el circuito original: para valores “grandes”, la aproximación de “impedancia 
infinita” funciona bastante bien. 


1.2.5 Grafos de enlaces de potencia 


Un grafo de enlace de potencia es una representación gráfica del flujo de po- 
tencia en un sistema. El formalismo con el que se construyen los grafos permite 
extraer un modelo matemático del sistema a partir del grafo. Este formalismo 
también permite sistematizar el proceso de construcción del modelo, y por 
tanto es posible desarrollar herramientas de software que, a partir del grafo, 
construyan un modelo matemático y lo simulen directamente. En [Bor10] se 
hace una presentación detallada y extensa de la técnica de grafos de enlace de 
potencia. En la presente sección solo se presentan los fundamentos mínimos 
de ella. 

En cada uno de los elementos del grafo se definen dos variables: esfuerzo 
e y flujo f. Para el modelado de sistemas físicos, la selección de estas variables 
debe ser tal, que su producto sea la potencia p desarrollada en ese elemento: 


p(t) = e(t)F(t) (1.58) 


Los elementos con los que se construye uno grafo de enlace de potencia 
son de tres tipos (véase la figura 1.3): 
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GE1. Elementos de un puerto: intervienen una variable de esfuerzo y una 
variable de flujo. Los principales casos son: 


= Elemento R: el flujo es directamente proporcional al esfuerzo: 


et=RHO ff) ==> (1.59) 


Elemento 1: el esfuerzo es directamente proporcional a la varia- 
ción de flujo: 
df (t) 1 


a O) 109 =3 «oa 10) (1.60) 


Elemento C: el flujo es directamente proporcional a la variación 
de esfuerzo: 


a «0 =G [ 104t+0) (1.61) 


Fuente de esfuerzo S.: el esfuerzo es conocido e independiente del 
flujo: 
e(t) = Se (1.62) 


Fuente de flujo Sy: el flujo es conocido e independiente del 
esfuerzo: 


f(0)=S, (1.63) 


GF2. Elementos de dos puerto: elementos que relacionan dos parejas de va- 
riables esfuerzo-flujo de igual potencia. Existen dos casos: 


= Transformadores: el esfuerzo de un puerto es directamente pro- 
porcional al esfuerzo del otro puerto: 


_ Lale) 
k 


er (t) = kea(t) f1(t) pi(t) = pa(t) (1.64) 


= Giradores: el esfuerzo de un puerto es directamente proporcional 
al flujo del otro puerto: 


er(t) =kfa(t) f1(t) = pi(t) = pa(t) (1.65) 
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GE3. Uniones (elementos multipuerto): elementos de acoples entre otros ele- 
mentos del grafo. Algunos de los acoples pueden considerarse de en- 
trada (suministran potencia) y otros de salida. La relación básica es la 
continuidad de potencia: 


teta) =maadO: DD) aurRa= >). OO 


entradas salidas 


Existen dos casos especiales: 


= Uniones tipo 0: los elementos acoplados comparten el mismo es- 


fuerzo: 
er(t) = ex(t) = +: =enlt) y f:(t) = y fi(t) 
entradas salidas 
(1.67) 
= Uniones tipo 1: los elementos acoplados comparten el mismo 
flujo: 
H0=40===5M0 —, «=>» 40 
entradas salidas 
(1.68) 
Elementos de un puerto Uniones 


Figura 1.3 Elementos de un grafo de enlace de potencia 


En términos generales, el proceso de modelado con grafos de enlace con- 
templa tres etapas: 


BG.1. Construcción del grafo: la estrategia básica consiste en descomponer 
el sistema en sus elementos más simples, y representarlos por alguno 
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de los elementos básicos anteriormente enumerados. Además, existen 
procedimientos específicos para ciertos dominios físicos. En [Bor10] 
(sección 2.7) se explican algunos de estos procedimientos para sistemas 
mecánicos, eléctricos, magnéticos, hidráulicos y térmicos. 


Asignación de causalidades: consiste en determinar para cada elemen- 
to del grafo cuál de las dos variables (esfuerzo y flujo) será calculada 
a partir de la otra. Se trata, entonces, de una causalidad computacio- 
nal que no está relacionada con la causalidad física del sistema. Existen 
procedimientos explícitos para “causalizar” el grafo (véase el capítulo 4 
de [Bor10]). 


Extracción de ecuaciones: una vez asignadas las causalidades, es ele- 
mental extraer de cada enlace las relaciones matemáticas individuales. 
Es posible procesar manualmente estas relaciones para obtener mode- 
los de espacio de estado del sistema. También es posible entregar el lis- 
tado extenso de ecuaciones a algoritmos que las procesen y simulen 
(véase capítulo 2). 


Ejemplo 1.6: Modelado con grafos de enlace de potencia. 


En sistemas eléctricos, las variables de esfuerzo y flujo que se utilizan son la 
diferencia de potencial v(t) y la corriente ¿(t), que satisfacen p(t) = v(t)i(t). 
El circuito de la figura 1.1 puede representarse por el siguiente grafo de enlace 
de potencia: 


TI: Li IT: Lo 

e2 | fa €al fa 
Se _ ts 1 A 0 A 
E  Hh 3 $5 


Nótese que la conexión serie ha sido modelada por una unión tipo 1, en tanto 
que la conexión paralelo lo ha sido por una unión tipo 0. El árbol causalizado 
se muestra a continuación: 
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IT: Li IT: La 
e2| fa ea | fa 


Se 
5 == 1 LES 0 Es C:C 
E fi E Í5 
Las pequeñas marcas perpendiculares distinguen los dos tipos de causalidad: 


= Salida de esfuerzo: la marca está en la cabeza del enlace (como en los 
elementos tipo / de este ejemplo) y significa que la variable que será 
calculada es el esfuerzo. 


= Salida de flujo: la marca está en la cola del enlace (como en el elemento 
tipo C de este ejemplo) y significa que la variable que será calculada es 
el flujo. 


Es posible entonces obtener las siguientes ecuaciones básicas: 


= Ecuaciones de los puertos: 


er =0 ea = La fa e4 = Lo fu $5 = Cés (1.69) 
= Ecuaciones de las uniones: 


Kh=f=$f e1 = e2 +83 €3 = €4 =€5 f3=fi+$f 
(1.70) 


Si seleccionamos las variables que están derivadas (fa, f4, es) como variables 
de estado, podemos procesar las relaciones simples para desarrollar un modelo 
de estado. Para ello, buscamos las ecuaciones correspondientes a las derivadas 
de las variables de estado: 


= La ecuación diferencial para la derivada de fa: 


z ea ez — 83 E-— €e5 
= = = 1.71 
2 ni 7 í (1.71) 


= La ecuación diferencial para la derivada de fu: 


: €4 e5 
=D 1.72 
fa Lu (1.72) 
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= La ecuación diferencial para la derivada de es: 


e _ je pi 


Ep 1,73 
o ña did 
Estas tres ecuaciones se pueden escribir en forma matricial así: 
f 0.0. I/O f/f 1/L1 
fi =| 0 0 1/L> fl+| 0 JE (1.74) 
és 1/€ -1/C 0 e5 0 


Esta ecuación coincide con la ecuación 1.20, haciendo 11 = fa = 11, %2 = 
fa = úLy, 3 = €5 = Ue. 


1.2.6 Modelado orientado a objetos 


El enfoque de la programación orientada a objetos (OOP, sigla según el nom- 
bre en inglés) tiene sus raíces en los problemas de simulación”. No obstante, el 
desarrollo de un paradigma de modelado orientado a objetos (DOM) es poste- 
rior al paradigma de programación orientada a objetos. En [Elm78], Elmgqyvist 
construye las bases del modelado orientado a objetos, como una forma de su- 
perar las limitaciones de los lenguajes de simulación basados en los diagramas 
de bloques, y en particular para evitar los errores de modelado que pueden 
surgir con ese enfoque (véase el ejemplo 1.5). 

En [CEOL95] y en [Bor10] se presentan las características mínimas del 
paradigma OOM, la gran mayoría de las cuales también están presentes en el 
paradigma OOP: 


OOM.1. Instanciación de objetos: una clase es una definición genérica de un 
modelo. Esta definición se vuelve especifica cuando se crea un objeto 
de esa clase. En otras palabras, un objeto es cada instancia que se 
crea de la clase. De esta forma, es posible reutilizar el modelo que 
reside en la clase en múltiples instancias. 


El primer lenguaje de programación orientado a objetos fue Simula 67. En su presentación se argu- 
mentaba la necesidad de un nuevo enfoque que permitiera la “organización e implementación de programas 
muy complejos y altamente interactivos, tales como los grandes programas de simulación” [DMN70]. De 
hecho, uno de los primeros ejemplos en ese mismo documento consiste en la implementación de una clase 
dedicada a la simulación de eventos discretos. Una revisión histórica del paradigma OOP se encuentra en 
[Cap03]. 
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O0OM.. 


OOMA3. 


OOM.4. 


OOM.. 


OOM.E. 


O0OMZ7. 


Encapsulamiento del conocimiento: la información de cada objeto 
está encapsulada, lo que significa que un objeto guarda su informa- 
ción internamente sin mezclarse con la información de otros objetos. 
Esta característica protege la información propia de cada objeto, de 
tal manera que en el diseño de las clases no es necesario preocuparse 
por los efectos que otros objetos (quizás aún no diseñados) puedan 
llegar a tener accidentalmente. 


Capacidades de interconexión topológicas: los objetos pueden inter- 
conectarse para ensamblar modelos más sofisticados. Los mecanis- 
mos de conexión deben ser tales que permitan un diseño tipo plug 
and play a nivel de software. 


Capacidades de construcción de redes generalizadas: uno de los me- 
canismos de interconexión disponibles son nodos que permiten co- 
nectar un número arbitrario de elementos y, de esta forma, construir 
redes complejas de objetos. 


Modelado jerárquico: un modelo sofisticado puede contener mode- 
los más simples en su interior. Esta característica busca que el mo- 
delo pueda reflejar las estructuras reales que existen en el sistema 
modelado. 


Herencia de clases: mediante este mecanismo es posible definir clases 
especializadas a partir de una o más clases base. La herencia facilita 
la organización, reutilización y mantenimiento del código, así como 
la construcción de librerías estructuradas. 


Polimorfismo: esta característica permite la definición de interfaces 
genéricas para conectar elementos de diferentes tipos, lo que facilita 
la construcción de clases genéricas, cuyo comportamiento se hace 
explícito en diferentes clases especializadas. 


La utilización de estas características con propósitos de modelado de sis- 
temas dinámicos se resume en [Fril4] así: 


= “La orientación a objetos se usa principalmente como un concepto es- 
tructurador, enfatizando la estructura declarativa y la reutilización de 
modelos matemáticos. Nuestras tres formas de estructurar son las jerar- 
quías, la conexión de componentes y la herencia”. 


= “Las propiedades de los modelos dinámicos se expresan de forma decla- 
rativa a través de ecuaciones”. 
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= “Un objeto es una colección de variables de instancia y ecuaciones que 
comparten un conjunto de datos.” 


También en [Fril4] se propone una metodología de construcción de mo- 
delos orientados a objetos mediante la siguiente estrategia: 


00.1. 
00.2. 


00.3. 


00.4. 


00.5. 


00.6. 


Definir brevemente el sistema. 


Descomponer el sistema en sus componentes principales y diagra- 
mar las clases del modelo o utilizar clases predefinidas en librerías 
disponibles. 


Definir la comunicación, es decir, las vías de interacción entre los 
componentes. 


Definir las interfaces, es decir, los conectores externos de cada com- 
ponente. Mediante estos conectores, cada componente se comunicará 
con otros componentes. Si es necesario, se deben definir nuevas clases 
de conectores que permitan un alto grado de reutilización y conectivi- 
dad, pero permitiendo un grado de revisión de tipo adecuado. 


Descomponer recursivamente los componentes del modelo. En cada 
iteración se aplica la metodología desde el paso OO.2, lo que conlleva 
la disminución progresiva de la complejidad de los componentes y co- 
nectores. El proceso se lleva a cabo hasta que todos los modelos sean 
definidos, o bien como instancias de clases o tipos predefinidos, o bien 
por nuevas clases definidas por el usuario. 


Formular nuevas clases de modelo donde sea necesario, tanto clases 
base como derivadas: 


= Declarar nuevas clases de modelo para todos los componentes que 
no sean instancias de clases predefinidas. 


= Declarar las posibles clases base para incrementar la reutilización 
y la mantenibilidad de las clases. 


En este procedimiento, el paso OO.4 es el más difícil, sin lugar a dudas. 
La definición de los mecanismos de interconexión requiere no solo un co- 
nocimiento profundo de los fenómenos que se modelarán, sino también una 
buena experiencia como modelador. Un mecanismo de interconexión bien 
diseñado debe: 
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= Permitir una conexión fácil y natural de los objetos. En particular, para 
sistemas físicos, debe reflejar la forma como estos sistemas se conectan 
realmente. 


= Facilitar la reutilización del modelo en condiciones muy generales. 
Debe evitarse el diseño de conectores ad hoc, es decir, aquellos que solo 
funcionan bajo condiciones muy específicas. 


Es claro que el OOM por sí solo no es suficiente: se necesitan herramien- 
tas específicas de software que procesen los modelos para generar y simular 
los modelos matemáticos explícitos. En estos ambientes de modelado y simu- 
lación, tales tareas pueden ser más o menos transparentes para el modelador. 
Además, como consecuencia de las características del OOM, dichos ambientes 
suelen ofrecer librerías de modelos multidominio prediseñadas, que facilitan 
la tarea del modelador. Estas librerías pueden incorporar tanto modelos con- 
tinuos, como discretos e híbridos. 


Ejemplo 1.7: Modelado orientado a objetos. 
Para obtener un modelo orientado a objetos del circuito de la figura 1.1, pri- 


mero se identifican los componentes interconectados, tal como se muestra a 
continuación: 


Tierra 


Para construir el modelo se ha utilizado el lenguaje Modelica (véase 
capítulo 3), apoyados en las definiciones disponibles en la Modelica Standard 
Library (véase sección 3.3). El código fuente del modelo es el siguiente: 
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Archivo 1.1 LLC/LLC.mo 


El siguiente diagrama muestra las relaciones jerárquicas entre las clases pre- 
definidas que se han usado en la construcción del modelo. Puede observarse 
que la clase OnePort funciona como clase base para las clases especializadas 
Inductor, Capacitor y Voltage Source: 


Con la ayuda del ambiente de simulación OMEdit, que forma parte de la sui- 
te OpenModelica (ver capítulo 4 y sección 4.7) se ha simulado el modelo. El 
resultado se presenta a continuación: 
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CC o] ¡ | 2, 


u 


o eri feiridaiaa tradi ti 


tiempo (s) 


Para lograr esa simulación, la herramienta de software genera en un paso in- 
termedio un conjunto de relaciones matemáticas. Estas relaciones se constru- 
yen sobre las definiciones de variables y parámetros predefinidos en la librería, 
que para este ejemplo resultan ser los que se muestran en las tablas 1.1 y 1.2. 
Las relaciones matemáticas construidas por la herramienta de software son las 
siguientes: 


L1.L * der(L1.i) = Ll1.v; 
L1d.v = Ldl.p.v = L1.n.v; 
0.0 =Li.p.i + Ll.n.i; 
L1.i = Li.p.i; 
L2.L * der(L2.i) = L2.v; 
12.4 = L2.p.v = L2,.n.v; 
0.0 = L2.p.i + L2.n.i; 
12.i = 12.p.i; 
j= * der(C.v); 
.v- C.n.v; 
.i-+ Cn. i; 
SL 
.p.v On 
E.signalSource.y = E.signalSource.ofíset + 
(if time < E.signalSource.startTime then 0.0 
else E.signalSource.height); 
E.v = E.signalSource.y; 
E.v = E.p.v - E.n.v; 
0.0 = E.p.i + E.n.i; 
E.i = E.p.i; 
L1.p.i + E.p.i = 0.0; 
Lim, i + L2p.1 +€.p.i =.0.0; 
12,n,1 + C.n.i + 6.p.i + E.mn.i = 0.0; 
E.p.v = L1.p.v; 
C.p.v = L1.n.v; 


anoaa 
pos. 
0 
rana 
ouvWa 
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L2.p.v; 
E.n.v; 
G.p.v; 
L2.n.v; 


aaaa 
BBB 


43 << 


Para simular el circuito de la figura 1.2 puede hacerse uso de la herencia de 
clases, con el siguiente código: 


Archivo 1.2 LLC/LLCRextends.mo 


model LLCR 

extends LLC; 

Modelica. Electrical. Analog. Basic. Resistor R(R=1); 
equation 

connect(C.p,R.p):; 

connect(C.n,R.n); 
end LLCR; 


El resultado de la simulación para R = 10) se grafica a continuación 


== Corriente en R 


o- , ; : , ; , : , ; , : : , : , ; , ! 


tiempo (s) 


1.3 COMPARACIÓN DE LAS TÉCNICAS DE MODELADO 


Los ejemplos 1.1 a 1.7 muestran la existencia de importantes diferencias entre 
una técnica de modelado y otra. De esas diferencias podemos destacar: 


a. La robustez de la técnica de modelado, que consiste en su capacidad para 
generar modelos correctos, es decir sin errores. Las técnicas más robustas 
son las diseñadas para dominios específicos, debido a que se han cons- 
truido dentro de marcos de referencia cerrados que dan un escaso margen 
de error. En [CEOL95] se identifican tres fuentes de error conceptuales 
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b. 


comunes que pueden generar modelos erróneos. Los errores surgen de la 
aplicación incorrecta de ciertas técnicas de modelado, frente a lo cual se 
identifican como las más robustas las técnicas variacionales, los enlaces de 
potencia y el modelado orientado a objetos. Los errores referidos son!': 


= Considerar que los modelos de espacio de estado son la base de la 
física. Debido a la popularidad y utilidad de los modelos de estado, 
particularmente en el área de la ingeniería de control, es usual inten- 
tar descripciones de los fenómenos físicos tan cercanas a los modelos 
de estado como sea posible. En este intento, es posible obviar inad- 
vertidamente algunos fenómenos físicos relevantes para el modelo. 


= Considerar que las señales capturan el fenómeno físico. La popula- 
ridad de los diagramas de bloques, y su gran aplicabilidad en áreas 
como el procesamiento de señales hace que en ocasiones se olviden 
los efectos de la interconexión de sistemas, tal como se muestra en el 
ejemplo 1.5. 


= Considerar que la causalidad es la base de la física. La causalidad es 
en realidad la metáfora que utilizamos para interpretar los fenómenos 
físicos. Es frecuente confundir la causalidad física con la causalidad 
computacional. La naturaleza es en esencia acausal, en el sentido de 
que los fenómenos suceden sin que podamos asegurar que uno sea la 
causa de otro, aunque usualmente los interpretamos como si así fue- 
ra. Por su parte, la causalidad computacional determina el orden en 
que podemos calcular las variables del modelo; este concepto es par- 
ticularmente relevante en los modelos de grafos de enlace de potencia 
y en los modelos orientados a objetos. 


La eficiencia del modelo generado, que es su capacidad para representar el 
sistema con pocos recursos. Los modelos generados con técnicas analíticas 
de dominios específicos son los más eficientes, mientras que los modelos 
orientados a objetos son los que menos. Esto se ve claramente al compa- 
rar los modelos obtenidos en los ejemplos 1.1 y 1.7, ambos sobre el mismo 
sistema de la figura 1.1: en el primer caso, el modelo consiste en tres ecua- 
ciones diferenciales sobre tres variables y tres parámetros; en el segundo se 
trata de un conjunto de veintisiete ecuaciones sobre veintisiete variables y 
quince parámetros. 
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[eu31s nd]no [e9y] JO 10]99UUO) TeoY A'391NOS|[2u31s q A 22INOS[PBUBIS 
urd 34) 0JUT SUIMO]] JUSTINO V USJINO DAA TeoY rug 1 
urd 99) Je [erjuojog A [e 1yu9JOg DIH 1eoY NU A S 
urd 34) 0]UT SUIMO]] JUSTIMO V USJINO D19A]H TeoY rd 1 P El 
urd 99) Je [ernjuojog A [e13u9aJOg DEIA 1eoY ad A 
u ud 03 d urd u101] SUIMO], JUSTINO) v JU9IINO III Poy ra 1 
(au - ad ) surd 0M3 94] U99m33q doxp a3eJ]0p A [e U9JOG III TeoY NA A 
urd 34) 0JUT SUIMO]] JUSTIMO V USJINO DAA TeoY rd) 1 A 
urd 31) ye [eruajog A [e 1yu9JOg DIH 1eoY ado A 2 
urd 94) 07ur SULMo]y Ju9Jmo V UI) DAA Toy ru 1 
urd 31) Je [eruajog A [e1Ju9JOg DEIA 1eoY NU) A - 
urd 94) Out SULMO[y JU9IIMO Vv USIINO DAA TeoY rd 1 A 
urd 31) Je [enyuajog A [e 1yu9JOg DEIA 1eoY ado A 9 
u ud 0] d urd u101] SUIMO], JUSTIMO V JU9IIMO IIA Toy 1487 1 
(au - ad ) surd 0M3 34] U9S9m33q doxp a3eJ]0p A [e13u9JOg DEIA 1eoY 10) A 
urd 94) Out SULMo]y JU9Imo Vv USJINO DIAJH TeoY ruz] 1 
urd 314) Je [enuajog A [e 1yu9JOg DIH 1eoY AmUuZzT] A y 
urd 94) Out SULmo]y Ju9Jmo Vv UI) DIH TeoY rdz1 1 á 
urd 31) Je [eruajog A [e13u9JOg DEIA 1eoY Adz1 A el 
u ud 03 d urd v101] SUIMO]] JUSTINO V JUSIIMO INDIA Toy rzl 1 
(au - ard ) surd 0M3 3y] Uu99m3oq doxp a3eJ]OA A [e 1yu9JOg YI 1eoY NzI A 
urd 34) 07uT SUIMO]] JUSTIMO V USJINO D19AJH TeoY ru'IT 1 
urd 31) Je [eruajog A IT El 1eoY Au'TT A Ñ 
urd 94) 0Jur SULMO[y JU9IIMO Vv USJINO DIAJH TeoY rd171 1 3 
urd 314) ye [eruajog A [e 1yu9JOg IDA 1eoY acd'171 A YI 
u ud 03 d urd uo1] SUIMO]] JUSTIMO Vv JU9IINO III Toy II 1 
(au - ard ) surd 0M3 34] U99m33q doxp a3eJ]0p A [e 13u9JOg DEIA 1eoY ATT A 
uondins.q pepa Peppueo odtI, IQUION € PAIN T IPAIN TTPAIN 
aju9uoduro) 


LT o]duua(a [9p OJ9pOul [9p SA[GRIAPA T*T P[QRL 
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Tabla 1.2 Parámetros del modelo del ejemplo 1.7 


Componente 
Nivel 1 Nivel 2 Nivel 3 Nombre Tipo Cantidad Unidad Descripción 
L L1.L Real Inductance H Inductance 
L1 IC L1.IC Real Electric Current A Initial Value 
UIC L1.UIC Boolean Use initial condition value 
L L2.L Real Inductance H Inductance 
L2 IC L2.IC Real Electric Current A Initial Value 
UIC L2,UIC Boolean Use initial condition value 
Cc C.C Real Capacitance E Capacitance 
C IC C.IC Real Electric Potential v Initial Value 
UIC C.UIC Boolean Use initial condition value 
offset E.offset Real Electric Potential NA Voltage offset 
startTime E.startTime Real Time Ss Time offset 
E NA E.V Real Electric Potential NA Height of step 
offset E.signalSource.offset Real Offset of output signal y 
signalSource startTime E.signalSource.startTime Real Time Ss Output y = offset for time <startTime 
height E.signalSource.height Real Height of step 
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La eficiencia de los modelos también puede analizarse desde la facilidad 
para ser simulados. Las técnicas analíticas, las técnicas de espacio de estado 
y las técnicas variacionales generan Ecuaciones Diferenciales Ordinarias 
(ODEs u ODE, sigla según el nombre en inglés) compactas, en contras- 
te con las técnicas orientadas a objetos, que generan Ecuaciones Diferen- 
ciales Algebraicas (DAEs o DAE, sigla según el nombre en inglés) disper- 
sas. La simulación de las primeras es más sencilla que la de las segundas. 
En otras palabras, las exigencias para los métodos numéricos de simula- 
ción son mayores en el segundo caso (véase capítulo 2). 


La escalabilidad de la técnica, que es su capacidad para generar modelos 
cuando el tamaño del sistema a modelar, es decir su complejidad, aumenta. 
Las técnicas analíticas son las menos escalables, debido a que suelen reque- 
rir una cantidad importante de trabajo manual. En contraste, el modelado 
orientado a objetos tiene una de sus fortalezas en este aspecto, lo cual no 
es de extrañar, ya que justamente ese es uno de sus propósitos: facilitar el 
modelado de sistemas complejos. 


La interpretabilidad de los modelos generados, que está relacionada con 
nuestra capacidad de análisis de los mismos. Existen dos aspectos que afec- 
tan directamente la interpretabilidad: 1) el tamaño del modelo, y 2) la uti- 
lización de variables con sentido físico directo. Las técnicas analíticas son, 
por supuesto, las que generan modelos de mayor interpretabilidad. Los 
modelos de estado están en un puesto intermedio, mientras que los mo- 
delos orientados a objetos son los menos interpretables, sobre todo por su 
tamaño y el encapsulamiento de la información. 


La universalidad de la técnica, que es la capacidad de una técnica para 
construir modelos de todo tipo. Las técnicas menos universales son, co- 
mo es de esperar, aquellas definidas para un dominio específico, precisa- 
mente porque tienen su campo de acción restringido. En el otro extremo 
se encuentra la técnica orientada a objetos, no solo por su capacidad para 
abordar modelos multidominio (capacidad compartida con la técnica de 
grafos de enlace), sino por la capacidad de modelar eventos discretos, dis- 
continuidades, no-linealidades, y de incorporar el efecto de las condiciones 
iniciales. 

En particular, la habilidad para modelar eventos discretos es uno de los as- 
pectos relevantes de la técnica orientada a objetos. La Especificación de 
Sistemas de Eventos Discretos (DEVS, sigla según el nombre en inglés) 
suele emplearse para describir formalmente eventos discretos dentro de 
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ambientes de simulación (véase [ZPK00], [CK06]). La técnica orientada 
a objetos permite utilizar ese formalismo de manera transparante para el 
modelador, a través de las especificaciones del lenguaje de modelado. 


La universalidad de una técnica también puede analizarse como su capa- 
cidad para incorporar otras técnicas. Por ejemplo, en [Bor10] se muestra 
cómo obtener modelos variacionales a partir de grafos de enlaces; en este 
sentido, los grafos de enlaces son más universales que las técnicas varia- 
cionales. En [Zim06] se desarrolla una librería orientada a objetos para 
el diseño de grafos de enlace de potencia que emplean múltiples enlaces 
simultaneamente, lo que muestra que la orientación a objetos es más uni- 
versal aún. 


f. La versatilidad de la técnica, entendida como su capacidad para adaptarse 
a situaciones nuevas. Esta característica va de la mano de la universalidad: 
cuanto más universal una técnica, más versátil. 


1.4 EL MODELADO PARA UN LABORATORIO VIRTUAL 


Las diferencias reseñadas en la sección 1.3 hacen previsible que cada técnica de 
modelado tenga un nicho de aplicación en donde es más adecuada que otras 
técnicas. Es conveniente considerar la triada técnica-uso-herramienta (T-U- 
H) para encontrar esos nichos. Algunos de estos son: 


= T) Técnicas analíticas, U) interpretación de fenómenos físicos relativa- 
mente simples y de un único dominio, y H) rutinas de software que im- 
plementen métodos de simulación de ODESs genéricos. 


= T) Técnicas analíticas de dominios específicos orientadas a la simula- 
ción (como la del ejemplo 1.2), U) diseño y simulación de sistemas de 
un único dominio, y H) en ambientes de simulación propios de ese do- 
minio que implementen métodos de simulación numérica. 


= T) Técnicas variacionales en ciertos dominios específicos!!, U) análisis 
y simulación, y H) herramientas de software específicas. 


= T) Técnicas orientadas a objetos, U) análisis, diseño y optimización de 
sistemas multidominio de gran escala, y H) en ambientes completos de 
diseño, simulación y optimización tales como el que se muestra en el 
capítulo 4. 


11 Algunos casos son: robótica; modelos de dispersión de gases en la atmósfera; modelos del estado del 
tiempo. 
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En este contexto, ¿cuál es la técnica de modelado más adecuada para nues- 
tro laboratorio virtual? En la sección 6.1 se listan las especificaciones funciona- 
les de UNVirtualLab. Entre ellas, destacamos: propósito general, enfoque mul- 
tidominio, apoyo al aprendizaje, disponibilidad de modelos y licenciamiento 
abierto. 

El propósito general y el enfoque multidominio causan que las técnicas 
de un dominio específico no sean buenas candidatas. Por su parte, el apoyo 
al aprendizaje inclina la balanza hacia las técnicas que generan modelos cuya 
construcción refleja de forma más cercana el sistema real, tales como los grafos 
de enlace y las técnicas orientadas a objetos. La disponibilidad de modelos y 
el licenciamiento abierto nos lleva a la búsqueda de herramientas de software 
y librerías de modelos abiertas, punto en que las técnicas de enlace de grafos 
son particularemente débiles, en tanto que el modelado orientado a objetos es 
muy fuerte. 

Por estas razones, para la construcción de los modelos de UNVirtualLab 
seleccionamos las técnicas de modelado orientado a objetos; seleccionamos 
también el uso de lenguajes abiertos, así como de herramientas de software 
libre y sus librerías también libres (véanse capítulos 3 y 4). 
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SIMULACIÓN NUMÉRICA DE ECUACIONES 
DIFERENCIALES ALGEBRAICAS 


En general, el resultado del proceso de modelado orientado a objetos es un con- 
junto de ecuaciones simples, algunas de las cuales son diferenciales y otras son 
algebraicas. El concepto de Simulación numérica corresponde a la obtención de 
la solución de ese conjunto de ecuaciones simultáneas para un conjunto finito 
de instantes de tiempo. En este capítulo se presentan algunos conceptos bási- 
cos para comprender cómo se obtiene dicha simulación. La sección 2.1 destaca 
algunos aspectos conocidos sobre el comportamiento de las Ecuaciones Dife- 
renciales Algebraicas (DAESs, por su sigla en inglés) que dificultan su simula- 
ción. La sección 2.2 muestra el proceso general de simulación. Por su parte, 
las secciones 2.3, 2.4 y 2.5 profundizan algunos aspectos de dicho proceso. En 
la sección 2.6 se reseñan algunos problemas relativos al método numérico de 
simulación empleado. 


2.1 ANÁLISIS DE DAEs 


En términos generales, las DAE son sistemas de ecuaciones que combinan 
ecuaciones diferenciales con ecuaciones algebraicas. En su expresión más ge- 
neral, tienen la forma 


E(t, y, y) =0 (2.1) 


en donde FE es el conjunto de ecuaciones, y es el conjunto de variables y £ re- 
presenta el tiempo. En el contexto de la simulación de sistemas dinámicos, se 
plantea la restricción en la que el número de ecuaciones es igual al número 
de variables. En general, algunas de las ecuaciones serán diferenciales y otras 
serán algebraicas. 

Existen algunos casos especiales de DAEs que adquieren ciertas formas 
definidas en la literatura: 


= Forma implícita: corresponde a la ecuación 2.1. 


= Forma explícita: el vector y se separa para diferenciar las variables que 
aparecen derivadas (1) de las que no lo están (y); además, es posible des- 
pejar todas las derivadas y todas las variables que no están derivadas: 


de 
E AOS Y, t) 
y = g(z, t) pd 
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= Forma semiexplícita: el vector y se separa para diferenciar las variables 
que aparecen derivadas (1) de las que no lo están (y); además, es posible 
despejar todas las derivadas: 


d. ” 
a” =JFleut 
% g(x,y,t) dd 


= Forma semiexplícita autónoma: forma semiexplícita en la que la variable 
tiempo (t) no aparece de forma explícita en las funciones: 


a =J(z,y) 
d 
0 = g(z, y) qe) 


= Forma semiexplícita de Hessenberg: forma semiexplícita autónoma en 
la que las variables derivadas no aparecen en las ecuaciones algebraicas 
de forma directa: o 
ar =ÍF(x,y) (2.5) 
0 =gly) 


El problema de valor inicial consiste en encontrar una solución de 2.1 que 
también satisfaga y(to) = yo. En la sección 2.1.1 se muestra que el problema 
de valor inicial en las DAEs es más sofisticado que su equivalente para Ecua- 
ciones Diferenciales Ordinarias (Ordinary Differential Equations - ODEs). En 
la sección 2.1.2 se estudia la complejidad estructural de las DAEs, mediante el 
concepto de índice. 


2.1.1 Condiciones iniciales 


Para las ODESs, el teorema de existencia y unicidad de la solución establece 
que es necesario conocer los valores iniciales de todas las variables para poder 
determinar una única solución. En ese sentido, se pueden escoger libremente 
las condiciones iniciales. El problema de valor inicial consiste en encontrar la 
solución de la ecuación que satisface las condiciones iniciales. 

En el caso de las DAES, la situación es diferente. Consideremos una ecua- 
ción semiexplícita de la forma: 


de = 
a =F(0,yt) (2.6) 
0 =g(x,y,t) 
en la que x, y son vectores de tamaño N,,, N, respectivamente. En total hay 


N = N, + N, ecuaciones, de las cuales N,, son diferenciales y NV, son al- 
gebraicas. Debido a la presencia de las ecuaciones algebraicas, no todo punto 
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en RN formará parte de alguna trayectoria solución de 2.6. Pueden identifi- 
carse dos tipos de restricciones en las posibles soluciones de 2.6: 


= Restricciones explícitas: que aparecen de forma evidente en las ecuacio- 
nes algebraicas, y corresponden a los puntos de RY que las satisfacen. 


= Restricciones ocultas (o implícitas): que pueden aparecer por las relacio- 
nes entre las ecuaciones algebraicas y las diferenciales. 


Aquellos puntos que satisfacen las restricciones, tanto las explícitas como 
las ocultas, se denominan valores iniciales consistentes. Solo es posible encon- 
trar solución al problema de valor inicial de una DAE, si su valor inicial es 
consistente. 


Ejemplo 2.1: Restricciones ocultas. 


Se presentan a continuación tres casos de comparación: 


1. En primer lugar, tomemos la ODE simple: 
== (2.7) 


cuya solución está determinada de manera única cuando se establece la 
condición inicial 1, (tp) = 210 por 11 (t) = 210e!. Por esta razón no hay 
restricción alguna para establecer el valor de 210 . 


2. En segundo lugar, considérese la DAE de dos variables: 


1 = Zi 
(2.8) 
1 = +2 
La segunda de las ecuaciones establece una restricción sobre los valores 
que pueden tomar x1(t) y x2(t) en todo instante de tiempo, y en par- 
ticular para el tiempo inicial ty: las condiciones iniciales deben ser un 
punto de la circunferencia unitaria. 


3. Entercer lugar, considérese la DAE con tres variables (tomada de [Sch00]) 


Li = 21 
la = ma (2.9) 
l = 2i+2í 
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La tercera de las ecuaciones implica una restricción semejante a la del 
numeral anterior. No obstante, como el número de ecuaciones es 3, de- 
beríamos decir que las condiciones iniciales deben estar en el cilindro 
de radio unitario y eje definido por el vector [0, 0, 1]. Podemos entonces 
construir un subconjunto de R? en el que se satisface esta restricción: 


Mi =((201,12,13) ER | 2i+23=1) (2.10) 


Sin embargo, hay una restricción oculta adicional. Para hacerla evidente, 
solucionamos el sistema: 


x1(t) = xioe! 

za(t) = (1- ue?) q 
do = be 2300 (2.11) 
A 2(1—x210e2t)/ za(t) 

3) _ att) 

xa(t) E xa(t) 


La última de las ecuaciones 


establece la restricción adicional x3(t) = 


—2%(t) válida para todo instante de tiempo y, por tanto, también para 


to. El subconjunto de R3 en el que se satisface esta restricción es: 


M) = [ (21, 22, 23) ER? | 73 = —21) (2.12) 


Las trayectorias de 2.9 deben estar contenidas tanto en Mi como en Mo. 
Por tanto, el subconjunto de puntos M en el que se alojan las trayectorias 
está dado por 


M=M,NM) (2,13) 


La siguiente figura muestra los subconjuntos Mi, M2 y M. Destacamos 
que las condiciones iniciales de 2.9 solo pueden estar en M. 


3 23 


12 Y1 T2 Yl 12 


M> M=M¡Nn M») 
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2.1.2 Índices 


Un índice de una DAE es una medida de la complejidad estructural de la ecua- 
ción, o, en otras palabras, es una medida de qué tan diferente es una DAE a 
una ODE. Existen varias definiciones en la literatura! en función de los as- 
pectos que se quieran enfatizar de la estructura de la DAE. En el contexto de 
este documento utilizaremos la definición de índice de diferenciación que apa- 
rece en [Sch03], que se enfoca en determinar qué tan difícil puede resultar la 
simulación numérica de la DAE para los simuladores numéricos de ODESs: 


La DAE 2.1 tiene índice (de diferenciación) y si yu es el número mí- 
nimo de diferenciaciones 


E(t,y,y) =0 
ero) = 0 
t 
(2.14) 
drE(t, y) — 
a =D 


tales que las ecuaciones 2.14 permiten extraer un sistema de ecuacio- 
nes diferenciales explícitas usando sólo manipulaciones algebraicas. 


La importancia del índice de diferenciación radica en que da información 
acerca de qué tipo de tratamiento simbólico es conveniente realizar sobre la 
DAE para facilitar la labor del método de simulación seleccionado. De esta 
definición se desprende que una ODE es una DAE de índice 0. 


Ejemplo 2.2: Índice de diferenciación. 


Para ilustrar el concepto de índice de diferenciación, supóngase el caso en que 
las variables y de 2.1 se organizan como y = [x y]”, en donde x corresponde 
a las variables que están derivadas mientras que y corresponde a las que no lo 
están. Además, considérese el caso semiexplícito y autónomo: 


E =F(0,4) 
dt 
0 =g(x,y) si 


1 Además del índice de diferenciación, en [Sch03] se definen los índices: de Kronecker, de tratabilidad, 
de perturbación, de rareza y geométrico. 
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A continuación se analizan unos casos especiales de 2.15: 
1. Considérese la situación en la que todas variables se derivan: 
d 
a =J(2,y) (2.16) 


Claramente el sistema corresponde a una ODE, y por tanto el índice 
es 0. El caso 1 del ejemplo 2.1 se ajusta a 2.16 con x = 21. 


2. Considérese ahora el sistema de la ecuación 2.15 con variables derivadas 
y no derivadas. Para intentar convertir el sistema en una ODE, derivamos 
una vez la segunda igualdad: 


— dgíz,y) 
0 ala 
DE dales) dl mana. du (2.17) 
19) 3 (9) , 
o — le Dela, y) ye 96) dy 


dy : : ; Og(=2,y) , 
Para poder despejar 7? es necesario que el jacobiano dy Sea no sin- 


gular. En ese caso: 


dy  Og(w,y) *Og(z,y) 
dt Oy Ox Hr, y) Haste) 


En otras palabras, el sistema 2.15 es de índice 1 si Pes) es no singular. 


El segundo caso del ejemplo 2.1 corresponde a esta situación con 1 = 211, 
Y = 12. 
3. Considérese el caso en el que la ecuación algebraica es independiente de 


las variables no derivadas: 


di 9 


En esta situación, el jacobiano 291) es singular y por tanto el sistema 
no es de índice 1. Usando 2.17 tenemos la primera derivada: 
0 E) 
O = 90) $ (a, y) =h(x, y) (2.20) 

es decir, podemos construir el sistema auxiliar: 

de — 

dt Flo, y) (221) 

0 =h(x,y) 
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Por el caso anterior, sabemos que si el jacobiano es no singular, 
2.21 es de índice 1, y por tanto 2.19 es de índice 2. En esta situación, la 
ecuación 2.20 corresponde a la restricción oculta del sistema. 


Oh(x,y) 
Oy 


El caso 3 del ejemplo 2.1 corresponde a esta situación con x = [11 29]?, 


y = x3. Por tanto: 


Ka) = (2) a) =(+83-1) Y (00, 209) 
(2.22) 


La restricción oculta 2.20 es: 


hay) = A sa, y) = (21 2) E = 20 + 213 =0 


19) =p 
(2.23) 
es decir, la restricción oculta es 13 = —z?, tal como se había calculado 
en el ejemplo 2.1. 
L 


2.2 EL PROCESO DE SIMULACIÓN 


Considérese inicialmente el problema de obtener la simulación numérica de 


la ODE 
x(t) = f(x(t), u(t), t) 


2.24 
x(to) = Xo0 ) 


en la que x es el vector de estado (1; es la ¿-ésima variable de estado), u es el 
vector de entradas, £ es el tiempo, f es un vector de funciones, y la segunda 
ecuación establece las condiciones iniciales. Los métodos de simulación nu- 
mérica se basan en la expansión en series de Taylor de la solución: 


dx;(7) Parr) ?? 
xi(T +h)= zx (7) + - h+ 2 (2.25) 
Utilizando la nomenclatura f; para la ¿-ésima componente de f, se tiene: 
df; ae 
<i(T+h) = zur) + fir) -h+ a ÓN (2.26) 


Los distintos métodos de simulación difieren en la forma de calcular los 
términos de orden h? y superior. Por ejemplo, el método de Euler hacia ade- 
lante los desprecia: 
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zilTr+h)=zx lr) + fir) -h (2,27) 


xX(T+h)=x(7) +f(x(7),u(7),t) -h (2.28) 


El método de Euler hacia adelante tiene la estructura que se muestra en 
la figura 2.1. El método utiliza iterativamente las ecuaciones de estado para 
actualizar los valores de x y con estos, los valores de x. Esta estructura, no 
obstante, es insuficiente para simular numéricamente las DAESs. 


Ecuaciones de 
estado 


Método de 
integración 


Figura 2.1 Estructura del método de simulación de Euler hacia adelante 


Ejemplo 2.3: Método de Euler hacia adelante. 


Para ilustrar la estructura que se muestra en la figura 2.1, considérese la ODE 


simple 
EE) =al 
cuya solución analítica es x(t) = 
u(t)=0  f(utt),u(u),t) = axlt) 
x(T+h) = x(7) + ax(r)jh 


Tí 


o 


z(0) = 20; 


t 
xo qat 


La aplicación sucesiva de 2.28 da como resultado: 


t u(t) | x(t) F(t) = ax(t) x(t+h) 

0 0 LO LyAa xzo(1+ah) 
h 0 xo (1 + ah) xya(1 + ah) z0(1 + ah)? 
2h 0 zo(1 + ah)? zga(1 + ah)? xo(1 + ah)? 


En cada paso de iteración se utiliza la ecuación de estado +(t) = f(t) = ax(t) 
para actualizar el valor de x(t + h). 
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La figura 2.2 muestra la estructura general de un simulador numérico 
para DAEs. Sobre la estructura simple de la figura 2.1, se observan varias 


sofisticaciones: 


1 Métodos de paso fijo * 
Lazos algebraicos > 


Newton 


Ecuaciones de 
estado 


Método de 
integración 


Métodos implícitos 


h, orden 


l 
7 Control de paso y 
l orden 


- 


a a LW Hs e pu e 


Figura 2.2 Estructura de un simulador numérico para DAEs 


= La posible (y usual) presencia de lazos algebraicos no permite calcular de 
forma explícita x a partir de x. Si esto sucede, se requiere la aplicación 


de un método numérico de solución de ecuaciones del tipo Newton. 


= Si se utilizan métodos de simulación implícitos, la actualización de los 
valores de x en cada iteración requiere también de un método numérico 
de solución de ecuaciones del tipo Newton. Estos métodos tienen mejo- 


res condiciones de estabilidad que los explícitos. 
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= Si se utilizan métodos que automáticamente ajustan el tamaño de paso 
y el orden de integración, entonces es necesario incorporar el lazo de 
control de estas dos variables a partir de la estimación del error. Estos 
métodos son especialmente útiles para la simulación de problemas stiff, 
bien sea en ODEs o en DAESs. 


La figura 2.2 muestra también que las ecuaciones de estado son utilizadas 
reiterativamente en el proceso de simulación. Por esta razón, es crítico tener 
una representación numérica eficiente de ellas; en particular, debe buscarse 
que el ciclo de iteraciones de Newton para la solución de lazos algebraicos y 
singularidades estructurales sea lo más eficiente posible, o, mejor aún, que no 
se requiera tal ciclo, es decir, que se tenga una representación explícita. 

La sección 2.4 presenta una serie de algoritmos que utilizan representa- 
ciones simbólicas de las DAEs para disminuir la complejidad del ciclo de ite- 
raciones de Newton directamente asociado a las ecuaciones de estado. Estos 
algoritmos son indispensables en la simulación de problemas de alta comple- 
jidad en los que el número de ecuaciones es considerable (> 100). 

Por otra parte, antes de iniciar el proceso de simulación es necesario en- 
contrar un conjunto de condiciones iniciales consistente. La sección 2.3 ilustra 
este proceso. 


2.3 CÁLCULO DE CONDICIONES INICIALES 


En la sección 2.1.1 se muestra que no todo conjunto de valores iniciales es 
consistente. Esto significa que en el proceso de simulación de una DAE es ne- 
cesario disponer de procedimientos para encontrar valores iniciales consis- 
tentes. Existen varias propuestas en la literatura. En [Sch00] y en [BHLRP98] 
se relaciona una buena cantidad de ellas. 

No hay un algoritmo universal para la búsqueda de condiciones inicia- 
les consistentes. Tanto la diversidad de DAEs existentes, como la variedad de 
algoritmos de simulación, hacen que unos de ellos sean más adecuados que 
otros para problemas específicos. A título ilustrativo, presentamos aquí el al- 
goritmo propuesto en [BHLRP98] para encontrar los valores de v(tp) = vo a 
partir de u(ty) = uy en el sistema semiexplícito: 


0 =f(t, ú, u, v) 


0 =g(t,u,v) is 


94 


SIMULACIÓN NUMÉRICA DE ECUACIONES DIFERENCIALES ALGEBRAICAS 


Se trata de un esquema iterativo del tipo Newton, en el que se actualiza el 
valor de up, Vo de la siguiente forma: 


Uo pe Uo Ao 
(ve) a (e) , + al , (2.30) 


La corrección se establece en cada iteración como: 


Alo F=1 f(to, uo, vo) ) 
E =-J 2.31 
El Peal k ( ) 
en donde J es una matriz que se obtiene a partir de los jacobianos de f, g, y un 
paso de iteración h asl: 
pd fu HF hfu ad 
Ji 2.32) 
( hgu gr 


En caso de no contar con una expresión explícita de los jacobianos, es 
necesario obtener una aproximación numérica de ellos. En [BHLRP98] se ar- 
gumenta que este método es particularmente adecuado en combinación con 
los métodos numéricos que, de por sí, requieren un jacobiano, dado que no 
implicaría un esfuerzo de codificación adicional. 


Ejemplo 2.4: Condiciones iniciales consistentes. 


Considérese la ecuación 2.8 del ejemplo 2.1, que puede reescribirse como: 


O=f(t,4,u,v) =ú4=u 
O (2.33) 
0=g(t,u,v) =u*+u*-1 


en donde hemos renombrado u = u = x1,v = v = 22. Los jacobianos 
resultan ser las derivadas parciales simples: 


of 0g 
Ou 8 —= oy, A 
Of 0g 
fa =-% ==1 u=*.=- = 2 2.34 
du 5 y E ió 
of 0g 
f, ==. == 0 Y == 2 
dv E ay ñ 
Reemplazando en 2.32 se obtiene la matriz : 
- l1-=-h 0 
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Supongamos ahora que el algoritmo se inicia (k = 0) con los valores uy = 
Vo = 0,5. Estos valores no son una condición inicial consistente, dado que 
no satisfacen la restricción algebraica de 2.33, es decir, no está en la circunfe- 
rencia unitaria. La siguiente tabla muestra la evolución de estos valores en las 
primeras iteraciones del algoritmo: 


k=0 k=1 k=2 k=3 
uo | 0,5 —0, 00010001 0, 00000001 1,0003 x 10-22 
vo | 0,5 L0 0,9999999995 10 


El algoritmo converge hacia la pareja (uy, voy) = (0, 1) que sí satisface las res- 
tricciones, y por tanto es una condición inicial consistente. 


2.4 ALGORITMOS DE TRATAMIENTO SIMBÓLICO DE DAEs 
2.4.1 Ordenamiento y asignación de causalidad 


Consideremos de nuevo el proceso de simulación de la ecuación 2.1. Inde- 
pendientemente de cuál sea el método de simulación utilizado, este necesitará 
actualizar en cada iteración unos nuevos valores para un cierto vector de va- 
riables x, es decir, en cada iteración será necesario solucionar una ecuación de 
la forma G(x) = 0 que en forma explícita se escribe como: 


Gili, ma, EE Da) =0 


Ga(x1, 22, no Dn) =0 
(2.36) 


Gr(11, 72,* NN E) =0 


En cada iteración será necesario utilizar cada una de las relaciones G; para 
calcular las variables x,. Para resolver 2.36, hay dos posibles enfoques: utilizar 
un método numérico (Newton, por ejemplo) o intentar un análisis simbólico 
para despejar las x; y calcularlas. El primer enfoque puede ser extremadamen- 
te costoso desde el punto de vista computacional, mientras que el segundo no 
siempre podrá ser exitoso. 

El enfoque utilizado para resolver 2.36, en el contexto de la simulación 
de DAEs, puede resumirse como: realizar un análisis simbólico hasta donde 
sea posible, y aplicar un método numérico donde no lo sea. Es necesario en- 
tonces responder la pregunta: ¿hasta dónde será posible realizar un análisis 
simbólico? o en otras palabras ¿qué variables x; podrán despejarse mediante 
un algoritmo? 
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Para ilustrar el problema, supóngase el caso en que G(x) = 0 es de la 
forma: 
G1(51,22) = 11 + 22 =1) 
1537 
Ga(11, 12) = 19 —sin(t) =0 
En un cierto paso de iteración k será necesario actualizar los valores de 
xi(k— 1) y za(k — 1). Si se utilizan las ecuaciones en el mismo orden de la 
ecuación 2.37, la actualización será la siguiente: 


jlk) = —za(k = 1) 


x2(k) = sin(t;) (2.38) 


Nótese que la actualización de x, se haría con un valor “viejo” de x2. En cam- 
bio, si alteramos el orden en que utilizamos las ecuaciones, tendremos dispo- 
nible el valor actualizado de 12 cuando necesitemos calcular x;: 


xa(k) = sin(tz) 


se (2.39) 


Este ejemplo pone en evidencia, que es necesario determinar cómo se uti- 
lizará cada una de las n ecuaciones de 2.36 para actualizar los valores de las 
variables en cada paso de iteración. En forma concreta, es necesario: 


1. Ordenar las ecuaciones. 


2. Asignar causalidades, es decir, determinar la variable que se va a calcular 
con cada ecuación. 


Las dos tareas no son independientes: el ordenamiento dependerá de la 
causalidad, y viceversa. Para abordar estas tareas, nótese que es de esperar que 
no todas las variables 1, estén presentes en todas las ecuaciones G;. Hay dos 
formas equivalentes de representar la estructura de G(x) (es decir, las variables 
que intervienen en cada ecuación): 


= La matriz de incidencia estructural: se trata de una matriz n x n en la 
que cada fila representa una ecuación y cada columna una variable. El 
contenido de cada celda ¿ — j es un 1 o un O que representa si la variable 
j está presente o no en la ecuación ¿, respectivamente. 


= El dígrafo estructural: se trata de un grafo con 2n nodos, la mitad de los 
cuales representa las ecuaciones y la otra mitad las variables. Es usual 
dibujar el grafo como dos columnas de nodos una enfrente de la otra. 
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En el grafo se traza una conexión entre el nodo de la ecuación i y el nodo 
de la variable j, cuando la variable j está presente en la ecuación 1. 


Para efectos del proceso de simulación numérica, se busca reordenar 
las ecuaciones y variables de 2.36, de tal forma que su matriz de incidencia 
sea triangular inferior. Si se logra, el análisis simbólico habrá sido comple- 
tamente exitoso. 

En la sección 2.4.2 se muestra el algoritmo base para ordenamiento y asig- 
nación de causalidades. Este algoritmo logra construir, a partir de 2.36, un sis- 
tema de ecuaciones cuya matriz de incidencia es triangular inferior por blo- 
ques (BLT, sigla según su nombre en inglés). En la sección 2.4.3 se muestra un 
segundo algoritmo que realiza un análisis simbólico adicional sobre los blo- 
ques de la matriz BLT, para intentar evitar la necesidad de usar un método 
numérico; por su parte, la sección 2.4.4 muestra un tercer algoritmo útil que 
es útil para resolver los bloques de la matriz BLT' cuando estos constituyen 
ecuaciones lineales. 


Ejemplo 2.5: Matriz de incidencia. 


La matriz de incidencia del sistema de ecuaciones 2.37 es: 


1 1 
0» dao) 


Sin embargo, si se reordenan las ecuaciones y variables, el sistema de ecuacio- 
nes se puede escribir como: 


Ga(21, 12) = bi = sin(t) =0 


O A E (Q.41) 
G1(51, 72) = 11 +22 =0 


cuya matriz de incidencia resulta ser: 


1.0 
E 1) (2.42) 


Esta es una matriz triangular inferior. 
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2.4.2 El algoritmo de Tarjan 


El algoritmo de Tarjan? opera sobre el dígrafo estructural de un sistema de 
ecuaciones. Las operaciones se representan mediante colores que se van asig- 
nando a los nodos y a sus conexiones. Se utilizan tres colores: negro, azul y 
rojo. Inicialmente, todas las conexiones tienen color negro, y al finalizar el al- 
goritmo todas ellas tienen colores rojo o azul (ninguno es negro). Adicional- 
mente, al finalizar el algoritmo cada ecuación y cada variable tiene un número 
(un orden) asignado. El significado de los colores en un digrafo ya coloreado 
es el siguiente: 


= Conexión roja: si la conexión entre el nodo de la ecuación 1 y el nodo de 
la variable j es de color rojo, significa que la ecuación ¿ se utilizará para 
actualizar el valor de la variable j. 


= Conexión azul: si la conexión entre el nodo de la ecuación ¿ y el nodo 
de la variable j es de color azul, significa que, al momento de utilizar la 
ecuación i, el valor de la variable j ya fue previamente actualizado. 


Durante la ejecución del algoritmo es necesario distinguir los siguientes 
conceptos: 


a. Ecuación causal: ecuación cuyo nodo tiene exactamente una única cone- 
xión roja asociada. 


b. Ecuación acausal: ecuación cuyo nodo tiene solamente conexiones negras 
y azules asociadas. 


c. Variable conocida: variable cuyo nodo tiene exactamente una única cone- 
xión roja asociada. 


d. Variable desconocida: variable cuyo nodo tiene solamente conexiones ne- 
gras y azules asociadas. 


Desde el punto de vista del método de integración, las variables que deben 
integrarse son variables conocidas. Esta afirmación parece un contrasentido: 
¿no se supone que el método de simulación debe, precisamente, calcular el va- 
lor de esas variables? ¿Por qué pueden entonces considerarse como conocidas? 

La explicación puede visualizarse con el ejemplo 2.3. En cada paso del 
proceso de iteración se conoce un valor de x(t), que se utiliza para calcular 


2La presentación que se hace aquí del algoritmo se basa en la explicación que se encuentra en [CK06], 
sección 7.2. 
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el valor de x(t + h). De hecho, para t = 0 se conoce el valor de x(t) = x(0), 
la condición inicial. 

De igual forma, en cada iteración se conocen las variables que representan 
las variables exógenas, es decir, las entradas al sistema. El proceso de ordena- 
miento y asignación de causalidades se enfoca entonces en aquellas variables 
que no son conocidas al inicio de cada paso de iteración. 

El algoritmo consiste en la aplicación iterativa de dos reglas: 


Tr.1. Analizar todas las ecuaciones acausales así: si su nodo tiene únicamente 
una conexión negra asociada entonces: 


= Colorear de rojo esa conexión. 


= Identificar el nodo de variable que está al otro extremo de la cone- 
xión que se ha coloreado de rojo. 


= Asignar a la ecuación y a la variable un número. Este será el nú- 
mero entero más bajo disponible, comenzando con el número 1 y 
aumentándolo sucesivamente. 


= Colorear de azul todas las conexiones asociadas al nodo de la varia- 
ble identificada. 


Tr.2. Analizar todas las variables desconocidas así: si su nodo tiene únicamen- 
te una conexión negra asociada, entonces: 


= Colorear de rojo esa conexión. 


= Identificar el nodo de ecuación que está al otro extremo de la cone- 
xión que se ha coloreado de rojo. 


= Asignar a la variable y la ecuación un número. Este será el número 
entero más alto disponible, comenzando con el número n y dis- 
minuyéndolo sucesivamente. n es el número de ecuaciones, que es 
igual al número de variables. 


= Colorear todas las conexiones asociadas al nodo de la ecuación iden- 
tificada con color azul. 


El algoritmo termina cuando todas las conexiones se han coloreado o 
cuando no sea posible colorear ninguna conexión más. En ese momento se 
utilizan los números asignados a las ecuaciones y variables, así: 


= Las ecuaciones se ordenan de menor a mayor, utilizando el número 
asignado. 
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= La variable con el número asignado ¿ será actualizada utilizando la ecua- 
ción cuyo número asociado sea /. 


Ejemplo 2.6: Algoritmo de Tarjan. 


La tabla 2.1 muestra las ecuaciones que se generan al expandir el modelo del 
archivo rc.mo, que corresponde al modelo en lenguaje Modelica del circuito 
RC simple que se muestra en el diagrama siguiente (véase ejemplo 4.4): 


Diagrama 
R 
R=10 
A 
+ 3 
< 3 
id e 
S 
G 
Código 
Archivo 2% rc.mo 
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Nótese que en el listado de variables de la tabla 2.1 no se han incluido los pará- 
metros (tal como C.C, la capacitancia del condensador); tampoco se ha inclui- 
do la variable C.v (potencial en el condensador), ya que esta variable aparece 
derivada como der(C.v) y en consecuencia se considera conocida. 


Tabla 2.1 Numeración de ecuaciones y variables en el ejemplo 2.6 


No. Ecuación Variable 
1 g-p.v = 0.0; V.n.i 
2 R.R_actual = R.R * (1.0 + R.alpha * V.n.v 


(R.T_heatPort - R.T_ref)); 


3 R.v = R.R_actual * R.i; V.p.i 

4 R.LossPower = R.v * R.i; V.p.v 

5 R.v = R.p.v - R.n.v; V.i 

6 0.0 = R.p.i + R.n.i; V.v 

dl R.i = R.p.i; C,n.i 

8 R.T_heatPort = R.T; C.n.v 

9 C.i=C.C * der(C.v); C.p.i 

10 C.v == C.p.v - C.n.v; C.p.v 

11 0.0 = C.p.i + C.n.i; C.i 

12 C.i = C.p.i; der(C.v) 
13 V.v= V.V; R.R_actual 
14 V.v = V.p.v - V.n.v; R.T_heatPort 
15 0.0 = V.p.i + V.n.i; R.LossPower 
16 Vi =V.p.i; R.n.i 

17 g.p.i + C.p.i + V.n.i = 0.0; R.n.v 

18 R.p.i + C.n.i = 0,0; R.p.i 

19 R.n.i + V.p.i = 0.0; R.p.v 

20 R.n.v = V.p.v; R.i 

21 C.n.v = R.p.v; R.v 

22 C.p.v = V.n.v; g-p.i 

23 C.p.V = 8g.p.V; 8g-P.v 


Las figuras 2.3 y 2.4 muestran los resultados intermedios y finales de la apli- 
cación del algoritmo de Tarjan sobre las 23 ecuaciones y las 23 variables; la 
primera figura muestra los resultados en forma de grafos, y la segunda en for- 
ma de tablas. 
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El algoritmo concluye en la iteración número 4. La numeración resultante de 
ecuaciones y variables se emplea para reordenar tanto ecuaciones como varia- 
bles. El resultado se muestra en la tabla 2.2. El resultado también se visualiza 
en las figuras 2.3 y 2.4; el efecto del algoritmo de Tarjan se ve especialmente 
claro en la última tabla de la figura 2.4, que muestra cómo se ha obtenido una 
matriz de incidencia triangular inferior. 


Tabla 2.2 Ecuaciones y variables del ejemplo 2.6, una vez ordenadas con el algoritmo de Tarjan 


No. Ecuación No. Variable 

1 g.p.v = 0.0; 23 g-P.v 

8 R.T_heatPort = R.T; 14 R.T_heatPort 

13 V.v = V.V; 6 V.v 

23 C.p.V = 8g.p.v; 10 C.p.v 

2 R.R_actual = R.R * (1.0 + R.alpha * 13 R.R_actual 
(R.T_heatPort - R.T_ref)); 

10 C.v = C.p.v - C.n.v; 8 C.n.v 

21 C.n.v = R.P.v; 19 R.p.v 

22 C.p.v = V.n.v; 2 V.n.v 

14 V.v = V.p.v - V.n.v; 4 V.p.v 

20 R.n.v = V.p.v; 17 R.n.v 

E R.v = R.p.v - R.n.v; 21 R.v 

3 R.v = R.R_actual * R.i; 20 R.i 

7 R.i = R.p.i; 18 R.p.i 

18 R.p.i + C.n.i = 0.0; Z C.n.i 

11 0,0 =C.p.i + €.n.1; 9 C.p.i 

6 0.0 = R.p.i + R.n.i; 16 R.n.i 

12 C.i = C.p.i; 11 C.i 

19 R.n.i + V.p.i = 0.0; > V.p.i 

15 0.0 = V.p.i + V.n.i; 1 V.n.i 

17 g.p.i + C.p.i + V.n.i = 0.0; 22 g-p.i 

4 R.LossPower = R.v * R.i; 15 R.LossPower 

9 C.i=C.C *x der(C.v); 12 der(C.v) 

16 V.i= V.p.i; 5 V.i 
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Iteración 0 


es 
ARA Y 

SS 

Ns 


DN 
SS 


Figura 2.3 Aplicación del algoritmo de Tarjan al ejemplo 2.6, visualizado con grafos 
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La variable número 1 debe ser obtenida a partir de la ecuación número /. 


Como resultado, las ecuaciones de asignación de valores que resultan son las 
que se muestran en la tabla 2.3. Se ha empleado el símbolo := del lenguaje 
Modelica como operador de asignación. Esto no significa que sea necesario 
reescribir las ecuaciones en lenguaje Modelica. De hecho, el compilador rees- 
cribirá las ecuaciones en algún lenguaje de programación (probablemente C), 
como se explica en 4.4. 


Tabla 2.3 Ecuaciones de asignación en el ejemplo 2.6 


No. Ecuación 

1 g.p.v := 0.0; 

2 R.T_heatPort := R.T; 

3 V.v := V.V; 

4 C.p.V := 8g.p.V; 

5 R.R_actual := R.R * (1.0 + R.alpha * (R.T_heatPort - 
R.T_ref)); 

6 C.n.v = C.p.v - C.v; 

q R.p.v := C.n.v; 

8 V.n.v := C.p.v; 

9 V.p.v := V.v + V.n.v; 

10 R.n.v := V.p.v; 

11 R.v := p.v - R.n.v; 

12 R.i := / R.R_actual; 

13 R.p.i := i; 

14 C.n.i := - R.p.i; 

15 C.p.i = - C.n.i; 

16 R.n.i =- Rip.i; 

17 C.,i := C.p.i; 

18 V.p.i := - R.n.i; 

19 V.n.i := -= V.p.i; 

20 g.p.i := - C.p.i - V.n.i; 

21 R.LossPower := R.v * R.i; 

22 der(C.v):= C.i / C.C; 

23 V.i := V.p.i; 
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2.4.3 Algoritmos de rasgadura 


Los algoritmos de rasgadura se aplican sobre los bloques de la BLT de dimen- 
sión mayor que 1. El algoritmo básico consta de los siguientes pasos: 


Rs.1. 


Rs.2. 


Rs.3. 


Rs.4. 


Rs.5. 


Seleccionar una o más variables del bloque como variables de rasgadura. 
Suponer que el valor de las variables de rasgadura es conocido. 


Aplicar el algoritmo de ordenamiento sobre el sistema de ecuaciones con 
las nuevas variables “conocidas”. 


Construir la ecuación: 
S=Xn-x=0 (2.43) 


en la que x es el vector de variables de rasgadura, y el subíndice n se 
utiliza para distinguir un valor inicial supuesto (sin subíndice) y un valor 
nuevo. 


Utilizar un método numérico para resolver 2.43. 


Este algoritmo reduce el costo computacional de la utilización del método 


numérico al aplicarlo sobre un número reducido de variables. El algoritmo 
requiere la selección del conjunto de variables de rasgadura, que resulta ser 
un problema NP. Por esta razón, se utilizan heurísticas para la selección de las 
variables. En [CK06] se propone la siguiente: 


Ry. 1. 


Ry.2. 


Ry.3. 


Ry.4. 


Ry.5. 


Construir el digrafo estructural de las ecuaciones. 


Identificar las ecuaciones con la mayor cantidad de conexiones asocia- 
das a sus nodos (líneas negras). 


Para cada una de las ecuaciones identificadas, evaluar cuáles de las va- 
riables a las que están conectadas tienen el mayor número de conexiones 
asociadas (líneas negras). 


Para cada una de las variables identificadas en el paso anterior, deter- 
minar cuántas ecuaciones se convertirían en causales si dichas variables 
fueran conocidas, y marcar las que tienen el número mayor. 


Seleccionar una de las variables como la siguiente variable de rasgadura 
dentro las variables marcadas en el paso anterior. 
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Ejemplo 2.7: Algoritmo de rasgadura. 


Considérese el siguiente sistema de ecuaciones: 


1) Ti-"-Ta = 0 
2) TaoTa = 
3) Th Tp = 
2.44 
4) 11+T5 = ( ) 
5) tag —T5-—Tg = 
6) La — Za —Tg = 0 
cuya matriz de incidencia corresponde a: 

Eq 11 |T2 |Tz | Ta | T5 | 6 

1) 1 dl 0 0 0 0 

2) 0 0 1 1 0 0 

3) 0 0 0 0 1 1 

4) 1 0 0 0 1 0 

5) 0 0 1 0 1 l 

6) 0 1 0 1 0 1 
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Al intentar aplicar el algoritmo de Tarjan, se encuentra que no es posible cau- 
salizar ninguna ecuación, porque para todas ellas sus nodos tienen asociados 
más de una conexión negra. Hay, por tanto, un lazo algebraico, e intentamos 
aplicar el algoritmo de rasgadura. 

Para seleccionar las variables de rasgadura, identificamos la ecuación 6) co- 
mo la que tiene un mayor número de conexiones asociadas (3 en total). Las 
variables correspondientes a esas ecuaciones son 22, T4 y 16. De esas varia- 
bles, la que tiene más conexiones asociadas es 25 (3 en total). Por esta razón, 
seleccionamos xg como la variable de rasgadura en la ecuación 6). 


El nuevo sistema de ecuaciones es: 


1) xi-—wt2 =0 
2) Ta3=T4 = 
3) Ln — Tb = 

2.45 
4) 11+%, = 210) 
5) Ta -—T5s-—lgB = 0 
6) 12 Ta — Tb. — 0 


La causalización de x6 en la ecuación 6) permite colorear el digrafo estructural 
asl: 


Eq. 1 Vr. 1 


Despues de dos iteraciones, el algoritmo de Tarjan ha coloreado completa- 
mente el dígrafo: 
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Ea. 


Eq. 


Eq. 


Eq. « 


a 


Eq. 


Ea. 


El sistema de ecuaciones resultante es, entonces: 


T6n —T2— TA 
Tp =T6 
e (2.46) 
Tag =T5 +26 
T4a =Y3 
3 =11 


En el sistema de ecuaciones anterior, xg es un valor inicial estimado, que se 
recalcula como 26,, . Por lo tanto, podemos escribir la ecuación residual: 


T6n — T6 — 0 (2.47) 


que puede resolverse mediante métodos numéricos tipo Newton. Al comparar 
2.44 con 2.47, se observa que hemos disminuido considerablemente la dimen- 
sión del problema genérico F(x) = 0 (de dimensión 6 a dimensión 1). 


2.4.4 Algoritmo de relajación 


Existen varios algoritmos denominados “de relajación” en distintas aplicacio- 
nes computacionales. El algoritmo al que aquí nos referimos se emplea para 
manipular sistemas de ecuaciones lineales de la forma Ax = b, mediante una 
aplicación simbólica del método de eliminación de Gauss sin pivote. El algo- 
ritmo puede resumirse en el siguiente procedimiento: 
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Rj.1. 


Rj.2. 


Rj.3. 


Rj.4. 


Rj.5. 


Rj.6. 


Rj.7. 
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Causalizar las ecuaciones siguiendo el mismo procedimiento del algo- 
ritmo de rasgadura. 


Reescribir las ecuaciones dejando las variables desconocidas al lado de- 
recho de la igualdad, y realizando las multiplicaciones necesarias para 
evitar que aparezcan fracciones. 


Formular la ecuación matricial usando el orden de ecuaciones y variables 
asignado en la causalización. 


Aplicar iterativamente la eliminación gaussiana sin pivote, eliminando 
en cada iteración el elemento de la primera fila y primera columna. En 
cada iteración, se definen nuevas variables (auxiliares) en lugar de hacer 
las sustituciones simbólicas. 


Al finalizar las iteraciones se resuelve simbólicamente la ecuación final y 
se realizan las sustituciones simbólicas para cada variable. 


El conjunto de ecuaciones se ordena tomando primero las ecuaciones 
que definen las variables auxiliares en orden de aparición, y posterior- 
mente las ecuaciones que resuelven cada una de las incógnitas originales 
en orden contrario al original. 


Como resultado final se obtiene un conjunto de ecuaciones de tamaño 
mayor que el original, pero con la gran ventaja de tener una matriz de 
incidencia triangular inferior. 


Ejemplo 2.8: Algoritmo de relajación. 


Supóngase el sistema de ecuaciones: 


la a11%1 + a1222 = bj (2.48) 


2) a31121 + 49202 = ba 


cuya matriz de incidencia es: 


Eq X1 Ta 
1) ota 
2) 1 [1 
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El sistema puede representarse usando la matriz extendida: 


ar a12 | b1 
as 221 ba 


En el primer paso de eliminación gaussiana se obtiene: 


a a12 | b1 
0 C1 Ca 


en donde ha sido necesario definir las variables auxiliares c¡ y co: 


1 
C1 = 0422 — 4127021 
ajl 


1 
c2 = b2 — bi— 021 
a]1 


Las ecuaciones 2.50 y 2.51 se ordenan, entonces: 


1) a29 — a19591 =C1 
2) ba = b1 701 = Ca 
) 
) 


[(9u) 


C¡Ta = Ci 


4)  a11%1 + a12%2 =b1 


(2.49) 


(2.50) 


(2.51) 


(2.52) 


que resulta ser un bloque de tamaño 4, cuya matriz de incidencia es la matriz 


triangular inferior: 


H 


N 
a dd a Ma! 


ER 


(90) 


Ha 
O|-R|OoO|RPe 
ojo|jr| o 
ll a a) 
Rjojojo 


2.4.5 El algoritmo de Pantelides para la reducción del índice 


El algoritmo de Pantelides se utiliza para abordar las singularidades estructu- 
rales. Mediante un procedimiento simbólico, el algoritmo reduce en 1 el índi- 
ce de perturbación. Para problemas de índice elevado, es necesario aplicar el 
algoritmo en varias ocasiones. Es usual que la aplicación del algoritmo con- 
lleve la aparición de lazos algebraicos, que pueden abordarse con el algoritmo 


de rasgadura. 
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Las singularidades estructurales se manifiestan en la forma de ecuaciones 
de restricción algebraicas. En el proceso de ordenamiento de ecuaciones con 
el algoritmo de Tarjan, una de estas ecuaciones se detecta cuando su nodo 
solamente tiene asociadas conexiones azules. Se trata de ecuaciones en las que 
todas las variables ya tienen valores conocidos, y por tanto no hay ningún 
nuevo valor por calcular. 

El algoritmo de Pantelides consta de los siguientes pasos: 


Pt.1. Derivar simbólicamente la ecuación de restricción. En este proceso, es 
posible que aparezcan nuevas variables (las derivadas simbólicas). 


Pt.2. Adicionar la nueva ecuación al sistema. 


Pt.3. Equilibrar el número de variables y ecuaciones. La estrategia consiste en 
considerar algunas de las derivadas de las variables como nuevas varia- 
bles de estado; en otras palabras, se desconecta la relación de integración 
entre esa variable y su derivada. En ocasiones, basta con ignorar la ecua- 
ción de restricción. 


Ejemplo 2.9: Algoritmo de Pantelides. 


Considérese el sistema de ecuaciones: 


pue 


a= f(t) 


x3+t14= 0 


N 


(2.53) 
TT] = dt 


> q 
NE 
a 
8 
¡eu 


L2= dE 


Como las variables x3 y 14 aparecen derivadas, se consideran como variables 
de estado y, por tanto, como variables conocidas. Eso significa que la segunda 
ecuación es de restricción. Al derivar esa ecuación, el sistema se convierte en: 


1) za= f(t) 

2) t3+t4= 0 

3) aq= % (2.54) 
4) la = Es 

5) Ey Za= 0 
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Para equilibrar el número de variables y de ecuaciones, eliminamos la segunda 
ecuación: 


1) a= f() 
2) TI] = des 
; 2.55 
5) d E E de dl 
¡XL XL 
ay FE = 0 
La matriz de incidencia de este conjunto de ecuaciones es: 
Eq 21 292 dx3/dt dx4/dt 
1) 1 0 0 0 
2) 1 0 1 0 
3) 0 1 0 1 
4) 0 0 1 1 


Al reordenar las ecuaciones y variables se puede obtener una matriz triangular 
inferior: 


Eq 44] dx3/dt| dr4/dt| x2 
1) 1 0 0 0 
2) 1 1 0 0 
1) 0 1 1 0 
3) 0 0 1 1 


2.5 SIMULACIÓN DE EVENTOS DISCRETOS 


La simulación de una DAE se dificulta cuando las funciones involucradas pre- 
sentan discontinuidades. En general, los algoritmos de simulación numérica 
han sido diseñados y analizados bajo premisas de continuidad de las funcio- 
nes. Ante la presencia de discontinuidades, los algoritmos de integración sue- 
len fallar. En el contexto de la simulación de sistemas dinámicos, las disconti- 
nuidades reciben el nombre de eventos discretos o, simplemente, eventos. 

Los eventos pueden clasificarse en (ver [Naj05]): 


= Eventos temporales: cuando su ocurrencia está prevista en un cierto ins- 
tante de tiempo?. Las ecuaciones de diferencias finitas, por ejemplo, pre- 
sentan eventos temporales, ya que las discontinuidades suceden en ins- 
tantes de tiempo predefinidos. 


3El término temporal adquiere aquí la connotación de “asociado al tiempo”; no significa no perma- 
nente. 
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= Eventos de estado: cuando su ocurrencia depende del valor o de los valo- 
res que en algún momento tome o tomen una o varias variables del siste- 
ma. Un interruptor eléctrico controlado por un flotador, por ejemplo, es 
un evento de estado, pues la condición abierto/cerrado del interruptor 
dependerá del nivel del fluido que mide el flotador. 


¿Cómo simular eventos que contengan simultáneamente fenómenos con- 
tinuos y discretos? La estrategia consiste en separar el modelo en dos subsiste- 
mas, tal como se muestra en la figura 2.5. Los dos subsistemas pueden compar- 
tir variables comunes. La lógica subyacente a la separación puede explicarse 
así: 


= El disparo de los eventos está determinado por los valores que tomen 
algunas variables del sistema continuo (el tiempo puede ser una de ellas). 


= La ocurrencia de los eventos puede alterar el modelo del sistema conti- 
nuo. Estos cambios pueden ser: 


+ Un cambio (brusco) en el valor de una o más variables presentes en 
el modelo. 


+ Un cambio (brusco) en las ecuaciones que definen el modelo. 


Sistema 
continuo 


Cambio de 
modelo 


Variables 
comunes 


Disparador 
de eventos 


Sistema 
discreto 


Figura 2.5 Interacción entre variables de sistemas híbridos. Adaptado de [Naj05] 


Para que los dos subsistemas puedan convivir en un mismo ambiente de 
simulación, las variables discretas se transforman en continuas mediante re- 
tenedores de orden cero. La figura 2.6 reproduce el algoritmo propuesto en 
[And94] para simular conjuntamente los dos subsistemas. La lógica del algo- 
ritmo es la siguiente: 


= Los métodos de simulación numérica se emplean sobre la DAE, supo- 
niendo que no ocurre ningún evento. 
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= En cada paso de la simulación se verifica la ocurrencia o no de eventos, 
tanto temporales como de estado. 


= Cuando sucede un evento, se actualiza el modelo de la DAE antes de 
continuar con el siguiente paso de simulación. 


Existen algoritmos más sofisticados que el esbozado en la figura 2.6 (véan- 
se por ejemplo [Naj05, CK06]). Además, las herramientas de modelado de 
eventos juegan un papel preponderante en el diseño de los algoritmos (véa- 
se, por ejemplo, [UDO03]). 


Encontrar condiciones 
iniciales consistentes 
Verificar disparo de eventos 


Actualizar modelo y 
encontrar Cl consistentes 


Figura 2.6 Diagrama de flujo básico de un simulador híbrido. Adaptado de [And94] 


2.6 SELECCIÓN DEL MÉTODO NUMÉRICO 


En el corazón del proceso de simulación está el método de simulación numé- 
rica utilizado. La literatura que analiza estos métodos es abundante 
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y profunda (véanse por ejemplo [HNG00, HWO02, BT99]). La dificultad en 
la selección del método numérico radica en que su desempeño depende del 
problema que se va a simular. En otras palabras, no se puede conocer con 
anticipación cuál de los métodos disponibles es el más adecuado para un 
problema en particular. 

Si se dispone de un análisis matemático del problema a simular, quizás 
sea posible elegir o descartar algún método, basándose en las propiedades ge- 
nerales de este. Por ejemplo, para simular una ODE lineal de bajo orden y 
valores propios comparables, el método explícito de Euler es un buen candi- 
dato (aunque no es infalible). No obstante, cuando se trata de simular modelos 
obtenidos bajo el paradigma de modelado orientado a objetos, es muy difícil 
contar con el análisis matemático del modelo, porque este está generalmente 
disperso (y quizás oculto) en los modelos de sus componentes y conexiones, 
y solo se construye de forma integrada en tiempo de compilación. 

Las ventajas y desventajas de cada método disponible hacen que la selec- 
ción sea una tarea de balance en el desempeño. Así, por ejemplo, la facilidad 
de implementación y rapidez de cómputo del método de Euler explícito debe 
contrastarse con su pobre robustez. 

Se propone aquí un algoritmo simple para la elección del método de si- 
mulación: 


ML.1. Simular el modelo con todos los métodos disponibles y comparar los 
resultados. 


M1.2. Descartar los métodos que no convergen. 
ML3. Sino existen diferencias notorias en los resultados, ir al paso ML.6. 


ML4. Ajustar los parámetros de los métodos disponibles (tolerancia, paso de 
integración, orden, etc.) para intentar que los resultados de las simu- 
laciones sean comparables. Usar como referencia de comparación los 
métodos más robustos. 


ML5. Descartar los métodos con los que no haya sido posible obtener resul- 
tados comparables. 


ML:6. Analizar los tiempos de simulación de los métodos con simulaciones 
comparables. 


MI.7. Seleccionar el método con los menores tiempos de simulación. 
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Ejemplo 2.10: Ecuaciones stiff. 


En [HWO02] se analiza la siguiente ecuación como ejemplo de ecuación stiff 


dy — 
iS —50(y — cos(t)) (2.56) 


La siguiente figura muestra los resultados de la simulación numérica con el 
método de Euler para distintos pasos de integración. 


Función stiff 


0.5 7 


-0,5 l L l l 
0 0.2 0.4 0.6 0.8 


Si bien es cierto que, en términos generales, se espera que la precisión de la 
simulación dependa del paso de integración, la dependencia en este ejemplo 
es notable. Esa es la característica principal de los problemas stiff. 


Ejemplo 2.11: Desempeño de los métodos numéricos de simulación. 


Para ilustrar la dificultad en la selección del método, se ha desarrollado un 
experimento con algunos de los modelos que se presentan en la parte III. La 
tabla 2.4 muestra los modelos utilizados, así como las variables que se han 
escogido para comparar el desempeño de los métodos. 
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Tabla 2.4 Modelos y variables simulados en el ejemplo 2.11 


item Nombre Capítulo Archivo Variable 

a Motor DC 8 DCmotor.mo Corriente en la resistencia. 

b Cable aéreo 9 MysStandAloneLine.mo| Flecha de la catenaria. 

Cc Epidemia 10 dosserotipos.mo Modelo SIR-SI con naci- 
mientos. Infectados por el 
primer serotipo. 

d Estudiantes 11 ingresoConstante.mo Ingreso constante. Núme- 
ro total de estudiantes. 

e Central hidro- | 12 HidroPI.mo Frecuencia de la tensión 

eléctrica generada. 

f Modelo del mun- | 13 MyWorld3.mo Modelo de referencia. Po- 

do blación mundial. 

g Identificación al- | 14 idmasa.mo Masa estimada. 

gebraica 


El experimento diseñado se presenta a continuación: 


Ex.1. 


Ex.2. 


Ex.3. 


Ex.4. 


Ex.5. 


Se han seleccionado cinco de los métodos de simulación disponibles en 
la herramienta OpenModelica (véase capítulo 4). 


Se han simulado los siete modelos de la tabla 2.4 con cada uno de los 
cinco métodos. Para cada pareja modelo-método, se han corrido diez 
simulaciones. 


En cada simulación se han obtenido varios indicadores de desempeño. 
Para cada pareja modelo-método se han calculado los promedios de las 
siete simulaciones. 


Para poder comparar los resultados de desempeño, se ha seleccionado 
el método Dassl como referencia. Los promedios de los indicadores de 
desempeño se han normalizado tomando como referencia los prome- 
dios de desempeño del método Dassl. Los resultados se muestran en las 
tablas 2.7 a 2.10. 


Para cada método de simulación, se han calculado los promedios nor- 
malizados de sus indicadores en todos los modelos simulados. Los re- 
sultados se muestran en la tabla 2.5. 
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Tabla 2.5 Comparación experimental del desempeño de algunos métodos de simulación numérica. 
Véase el ejemplo 2.11 


Métodos 
medida dassl euler rungekutta inline- dasslwort 
rungekutta 
outputFilesize 1.000 0.992 1.002 1.008 1.000 
overheadTime 1.000 0.929 0.926 0.969 0.995 
preinitTime 1.000 0.950 0.945 0.976 1.003 
initTime 1.000 1.006 1.009 1.015 1.001 
eventTime 1.000 1.999 1.933 5.420 1.962 
outputTime 1.000 0.989 1.103 1.012 0.997 
total Time 1.000 0.576 0.639 1.789 0.768 
totalStepsTime 1.000 0.380 0.464 1.747 0.683 
numStep 1.000 1.001 1.000 1.009 1.000 
maxTime 1.000 0.943 0.869 0.861 1.577 


De acuerdo con los resultados de la tabla 2.5, el método más veloz 
(totalTime) es el de Euler, lo que lo hace muy atractivo. No obstante, la rapi- 
dez del método es un criterio secundario en función de su robustez: la figura 
2.7 muestra los resultados de simulación de las variables que se listan en la 
tabla 2.4 con los cinco métodos. 


Se puede observar que en tres de los siete casos analizados (a, e, g), los resul- 
tados de la simulación están fuertemente influenciados por la selección del 
método. Nótese que un caso aparentemente simple como el del motor DC (un 
modelo lineal de segundo orden) presenta dificultades para varios métodos. 
También es de anotar que para este experimento fue necesario descartar el 
método inline-Euler, debido a que no convergía con algunos de los modelos 
seleccionados. 
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a) Motor DC 


T 
"dassl_data.txt" u 1:2 
"euler_data.txt" u 1:2 

"rungekutta_data.txt" u 1:2 

"inline-rungekutta_data.txt' u 1:2 

"dasslwort_data.txt" u 1:2 4 


0 2 4 6 8 10 
b) Cable Aéreo 
27 T T T T T T T 
"dassl_data.txt" u 1:2 —— 
"euler_data.txt" u 1:2 —— 
"rungekutta_data.txt" u 1:2 —— 
ze L "inline—rungekutta_data.txt" u 12 —— | 


"dasslwort_data.txt" u 1:2 


2.5 


2.4 


23 


2.2 


21 


2 ñ Ñ ñ ñ ñ ñ ñ ñ 
o 10000 20000 30000 40000 50000 60000 70000 80000 90000 


c) Epidemia 


120 7 7 T 


7 
"dass]_data.txt" u 1:2 
"euler_data.txt" u 1:2 

"rungekutta_data.txt" u 1:2 

u12 

uta 


"inline-rungekutta_data.xt" 
"dasslwort_data.txt”" 


o 100 200 300 400 500 600 
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d) Estudiantes 


1200 T T T 
1000 F de: 
800 $4 
600 - $] 
400 F he 
200 F "dassl_data.txt' u 1:2 7 
"euler_data.txt' u 1:2 
"rungekutta_data.txt' u 12 —— 
"inline-rungekutta_data.txt" u 1:2 —— 
, ¡ "dasslwort_data.txt" ul2 — 
0 
0 5 10 15 20 
e) Central hidroélectrica 
66 T T T T T 1 
"dassl_data.txt" u — 
"euler_data.t —- 
65 p "rungekutta_data.txt" u 1:2 —— 7 
"irfline-rungekutta_data.txt" u — 
"dasslwort_data.txt" u 1:2 —— 
sab e] 
63 H 
62 | a 
61 Pp l l 
a LANA 
59 tp V 
58 p 7 
57 tp = 
56 p | 
0 100 200 300 400 500 600 700 800 900 
E) 
dle 
an 
Al 
e 
A 
de 
"dassl_data.txt" u 1:2 —— 
2 "euler_data.txt" u a 
"rungekutta_data.txt" u 1:2 —— 
"inline-rungekutta_data.txt" u 1:2 —— 
+ ñ "dasslwort_data.txt" u —— 


p 
1900 1950 2000 2050 2100 
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g) Identificación algebraica 


12 7 7 7 T 


"dassl_data.txt" u 1:2 7] 
"euler_data.txt" u 1:2 
"rungekutta_data.txt" u 1:2 
"inline-rungekutta_data.txt" u 1:2 
"dasslwort_data.txt"u 1:2 


o ñ ñ ñ 
0 1 2 3 4 5 


Figura 2.7 Simulación de algunos modelos de la parte III con varios métodos de simulación numérica. 
Ver el ejemplo 2.11 


2.6.1 Algunas consideraciones sobre los métodos de simulación 


La obtención de métodos de simulación numérica de ecuaciones diferenciales 
es un problema de vieja data. Leonard Euler expuso su método en el año 1768 
([Eul68]) e importantes avances se obtuvieron en el siglo XIX (el método de 
Adams aparece en 1855 y el de Runge en 1895). 

El listado de métodos desarrollados desde ese entonces es extenso. Las 
principales herramientas de software de simulación actuales utilizan como al- 
goritmo por defecto el método Dassl (Differential/Algebraic System Solver), 
que fue propuesto en 1982 por Linda Petzold en [Pet82]. El problema está le- 
jos de considerarse resuelto, y sigue siendo tema de investigación (véase, por 
ejemplo, la página web del grupo de investigación de Petzold en [oCaSB14]). 

El método Dassl tiene ciertas características que lo han convertido en la 
opción por defecto para la simulación numérica de DAEs*. Estas son algunas 
de ellas: 


= Más que un método, se trata de la implementación de la familia de mé- 
todos BDF (Backward Differentiation Formulas) de órdenes l a 5. 


= Como método, puede considerarse del tipo implícito, de paso variable y 
de orden variable. 


4Para una discusión detallada, ver [Naj05], sección 2.4.2. 
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= Incorpora una versión modificada del método de Newton en la solución 
del sistema lineal en cada paso. El método puede utilizar el jacobiano 
dado de forma explícita, o calculado numéricamente. 


= Su robustez radica en la habilidad para utilizar pasos estables grandes, 
manteniendo el nivel de precisión de otros métodos. 


= Es un método con buen comportamiento para la simulación de proble- 
mas stiff con un gran número de variables. 


= Tiene buena convergencia probada para sistemas explícitos de índice 1 
y semiexplícitos de índice 2. Sin embargo, requiere ser inicializado con 
un conjunto de condiciones iniciales consistentes, de lo contrario la con- 
vergencia no está asegurada. 


= Su implementación es abierta y robusta ([oCaSB14], sección Software). 


= Su implementación incluye varios submétodos especializados. 


Tabla 2.6 Comparación experimental del desempeño del método dass1 en relación al método dass1. 


Ver. Ver el ejemplo 2.11 
medida pea medida 
MotorDC Cable Central SIR-SI Estudiantes Identificación Mundo 
outputFilesize 1.000 1.000 1.000 1.000 1.000 1.000 1.000 1.000 
overheadTime 1.000 1.000 1.000 1.000 1.000 1.000 1.000 1.000 
preinitTime 1.000 1.000 1.000 1.000 1.000 1.000 1.000 1.000 
initTime 1.000 1.000 1.000 1.000 1.000 1.000 1.000 1.000 
eventTime 1.000 1.000 1.000 1.000 1.000 1.000 1.000 1.000 
outputTime 1.000 1.000 1.000 1.000 1.000 1.000 1.000 1.000 
total Time 1.000 1.000 1.000 1.000 1.000 1.000 1.000 1.000 
totalStepsTime 1.000 1.000 1.000 1.000 1.000 1.000 1.000 1.000 
numStep 1.000 1.000 1.000 1.000 1.000 1.000 1.000 1.000 
max Time 1.000 1.000 1.000 1.000 1.000 1.000 1.000 1.000 
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Tabla 2.7 Comparación experimental del desempeño del método euler en relación al método dass1. 
Ver . Ver el ejemplo 2.11 


medida E medida 
MotorDC Cable Central SIR-SI Estudiantes Identificación Mundo 
outputFilesize 0.972 1.000 1.017 0.959 1.000 0.994 1.000 0.992 
overheadTime 0.979 0.942 0.974 0.911 0.960 0.890 0.849 0.929 
preinitTime 0.942 1.000 0.896 0.926 0.974 0.946 0.967 0.950 
initTime 1.008 1.018 0.988 1.038 1.000 1.001 0.993 1.006 
eventTime 0.997 3.789 4.159 1.115 1.043 0.993 1.896 1.999 
outputTime 1.022 1.002 1.000 0.980 1.000 0.976 0.942 0.989 
totalTime 0.805 0.730 0.267 0.803 0.730 0.385 0.309 0.576 
totalStepsTime 0.434 0.518 0.195 0.343 0.509 0.363 0.296 0.380 
numStep 1.000 1.000 1.004 1.000 1.000 1.000 1.000 1.001 
max Time 0.032 1.109 0.891 0.279 0.719 0.654 2.914 0.943 


Tabla 2.8 Comparación experimental del desempeño del método rungekutta en relación al método 
dassl. Ver . Ver el ejemplo 2.11 


medida Sa medida 
MotorDC Cable Central SIR-SI Estudiantes Identificación Mundo 
outputFilesize 0.996 1.000 1.062 0.960 1.000 0.997 1.000 1.002 
overheadTime 0.972 0.920 0.941 0.917 0.955 0.899 0.877 0.926 
preinitTime 0.953 0.958 0.902 0.924 0.983 0.937 0.959 0.945 
initTime 1.015 1.001 1.009 1.037 1.002 0.999 0.996 1.009 
eventTime 1.005 3.744 3.721 1.122 1.041 0.999 1.895 1.933 
outputTime 0.988 0.990 1.026 0.979 1.000 0.984 1.758 1.103 
total Time 0.793 0.764 0.586 0.822 0.730 0.392 0.389 0.639 
totalStepsTime 0.458 0.588 0.542 0.415 0.508 0.369 0.368 0.464 
numsStep 1.000 1.000 1.000 1.000 1.000 1.000 1.000 1.000 
max Time 0.027 1.033 0.662 0.287 0.709 0.717 2.652 0.869 
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Tabla 2.9 Comparación experimental del desempeño del método inline-rungekutta en relación al 


método dass1. Ver 


. Ver el ejemplo 2.11 


medida E medida 
MotorDC Cable Central SIR-SI Estudiantes Identificación Mundo 
outputFilesize 0.961 1.055 1.077 0.967 1.000 0.999 1.000 1.008 
overheadTime 1.009 1.007 0.880 1.011 0.973 0.903 1.002 0.969 
preinitTime 0.993 0.982 0.939 0.958 0.999 0.964 1.001 0.976 
initTime 1.008 1.020 1.037 1.016 1.001 1.010 1.010 1.015 
eventTime 1.010 9.425 22.425 1.127 1.044 1.012 1.900 5.420 
outputTime 0.964 1.052 1.044 0.994 1.000 0.996 1.034 1.012 
totalTime 0.785 0.961 8.398 0.842 0.731 0.399 0.406 1.789 
totalStepsTime 0.474 0.913 9.116 0.447 0.509 0.376 0.394 1.747 
numStep 1.000 1.024 1.040 1.000 1.000 1.000 1.000 1.009 
max Time 0.030 1.097 0.697 0.515 0.693 0.605 2.387 0.861 


Tabla 2.10 Comparación experimental del desempeño del método dass1wort en relación al método 


dassl. Ver . 


Ver el ejemplo 2.11 


medida uta medida 
MotorDC Cable Central SIR-SI Estudiantes Identificación Mundo 
outputFilesize 1.000 1.001 1.000 1.000 1.000 1.001 1.000 1.000 
overheadTime 1.034 0.983 1.018 0.952 1.033 0.991 0.957 0.995 
preinitTime 1.035 0.996 0.986 0.990 1.006 1.017 0.989 1.003 
initTime 1.008 1.000 1.011 0.998 0.989 0.996 1.004 1.001 
eventTime 1.216 3.740 3.739 1.151 1.003 1.009 1.878 1.962 
outputTime 1.002 0.988 1.003 1.001 1.008 0.999 0.980 0.997 
totalTime 0.878 0.798 0.644 0.934 1.008 0.516 0.600 0.768 
totalStepsTime 0.663 0.647 0.608 0.761 1.009 0.498 0.592 0.683 
numStep 1.000 1.000 1.000 1.000 1.000 1.000 1.000 1.000 
max Time 0.876 1.040 1.990 0.887 1.088 0.716 4,444 1.577 
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EL LENGUAJE MODELICA 


Modelica es un lenguaje para el modelado de sistemas. No es un lenguaje de 
programación, aunque los modelos que se construyen con Modelica se simu- 
lan en computadores: el lenguaje está diseñado para describir las propiedades 
de sistemas. El énfasis en el diseño del lenguaje se ha hecho para adecuarlo al 
modelado de sistemas físicos dinámicos. No obstante, su versatilidad permite 
usarlo para otro tipo de sistemas, tales como los económicos y sociales. 

El lenguaje es utilizado por varias herramientas de software cuyo propósi- 
to es la simulación del comportamiento de sistemas dinámicos. En el capítulo 
4 se presenta una de ellas, y en [Ass18] se puede encontrar un listado de las 
más populares. Estas herramientas son las encargadas, entre otras cosas, de 
traducir la descripción del sistema en código ejecutable por un computador. 
En otras palabras, aunque Modelica no es un lenguaje de programación, en 
combinación con las herramientas adecuadas permite la generación automá- 
tica de código fuente en un lenguaje de programación!. Se trata de un len- 
guaje de uso abierto, no propietario, diseñado y mantenido por la Modelica 
Association?. 

En este capítulo se exploran algunas de las características más relevantes 
del lenguaje Modelica. No es, por tanto, un tutorial sino una presentación des- 
criptiva del lenguaje. En la literatura se encuentran varios documentos que sí 
son tutoriales. Es posible distinguir, al menos, dos tipos de ellos: 


= Tutoriales enfocados en las especificaciones del lenguaje: la estructura de 
estos documentos está alineada con la descripción formal del lenguaje 
(que se encuentra en [Ass12]). Estos documentos exploran el lenguaje a 
partir de las definiciones de sus elementos principales, tales como: tipo 
de operadores, clases, arreglos, ecuaciones, funciones, etc. Los ejemplos 
más relevantes de este tipo de tutoriales son [Fri04], [Fri14] y [Ass00]. 


= Tutoriales enfocados en las funcionalidades y ejemplos del lenguaje: la 
organización de estos documentos hace énfasis en cómo resolver pro- 
blemas de modelado. El lenguaje se presenta a través de conceptos como 
ecuaciones diferenciales, eventos, modelos híbridos, sistemas multido- 
minio, etc. Los ejemplos más relevantes son [Til01] y [Ti123]. 


1En la sección 4.4 se explica como realiza este proceso un compilador específico. 

2La Modelica Association es una organización no gubernamental sin ánimo de lucro cuyo propósito es 
el de desarrollar y promocionar el lenguaje de modelado Modelica. Se encarga también del desarrollo y el 
mantenimiento tanto del lenguaje Modelica como de la Modelica Standard Library. Ver [Ass25a]. 
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En las siguientes secciones se presentan las características más destacadas 
del lenguaje (sección 3.1) y algunos elementos mínimos para poder utilizarlo 
(sección 3.2). También se ha incluido una descripción de la librería abierta 
más utilizada de modelos Modelica (sección 3.3). A manera de introducción, 
los ejemplos 3.1 y 3.2 muestran la simulación de un modelo Modelica y un 
ejemplo mínimo, respectivamente. 


Ejemplo 3.1: Simulación de un modelo Modelica. 


Uno de los ejemplos que se incluyen en la Modelica Standard Library (véase 
sección 3.3) se ilustra en la figura 3.1. El ejemplo consiste en el bombeo de 
un fluido a través de un ducto. El diagrama muestra que el fluido es impulsa- 
do por una bomba a través de una válvula para que circule por el ducto. En 
el ducto, además, el fluido es calentado por convección gracias a una fuente 
de calor. 
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Figura 3.1 Diagrama y resultados de simulación para el modelo del ejemplo 3.1 
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En dicha figura se presentan también los resultados de la simulación para las 
variables de caudal y temperatura del fluido. La simulación se ha efectuado con 
la herramienta OMEdit (ver sección 4.7), incluida en la suite OpenModelica 
(ver capítulo 4). 


El ejemplo, además, se simula bajo las siguientes condiciones: 
= Temperatura ambiente de 20*C. 


= La bomba funciona a la mitad de la velocidad durante 0,4s; se acelera 
uniformemente durante 0,1s hasta llegar a la máxima velocidad. per- 
manece a velocidad máxima durante el resto de la simulación. 


= La válvula está abierta a la mitad durante 0,9s; se abre linealmente duran- 
te 0,1s hasta lograr la apertura máxima, con la que permanece durante 
el resto dela simulación. 


Ejemplo 3.2: Ejemplo mínimo. 


El código del archivo 3.1 corresponde al modelo de un sistema continuo de 


rimer orden definido por la ecuación Y = —x, sujeto a la condición inicial 
p di ) 
a) =T1 

Código 


Archivo 3.1 primerOrden.mo 


model test 

Real x(start=1); 
equation 

der(x)= —x; 
end test; 


En el código anterior puede observarse: 
= Un bloque delimitado por las expresiones model test y end test; 


= La separación de ese bloque en dos partes delimitadas por la expresión 
equation: el encabezado y la ecuación. 


= La definición en el encabezado de una variable x de tipo Real. 


= Un definición de una relación matemática con la expresión der (x)=-x; 


con de 
que corresponde a la ecuación $ = —2. 
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= La especificación de la condición inicial de la variable x con la expresión 
(start=1). 


Simulación 


tiempo (s) 


3.1 CARACTERÍSTICAS 
3.1.1 Modelo de componentes y conectores 


Un modelo complejo Modelica se construye conectando modelos más simples, 
tal como se ilustra en la figura 3.2. Cada componente del modelo está dotado 
de conectores. La conexión de dos o más componentes se realiza a través de esos 
conectores, ensamblando así el modelo mayor. 


Conector 


Figura 3.2 Conexión de dos componentes Modelica 


El diseño de los conectores es un aspecto crítico del modelado orientado a 
objetos. Por una parte, para cada tipo de acople físico entre sistemas es necesa- 
rio disponer de un tipo de conector. Por otra, el diseño de los conectores debe 
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ser lo suficientemente genérico para permitir acoples de componentes diver- 
sos. La figura 3.3 muestra un diagrama de conexión de varios componentes, 
en el que se ilustra que más de dos componentes pueden estar conectados a 


un mismo conector. 


Figura 3.3 Esquema de conexión de varios componentes Modelica 


En un conector se distinguen las variables de flujo de las que no lo son. 
La diferencia real entre estos tipos de variables se hace evidente cuando dos o 
más componentes se conectan a través de un conector: 


= Con las variables de flujo se construye una ecuación del tipo suma de 
variables igual a cero. 


= Con las variables que no son de flujo se construyen ecuaciones de igual- 
dad entre todas las variables. 


Ejemplo 3.3: Conexión de componentes. 


A continuación se muestra el diagrama de un circuito eléctrico RC alimenta- 
do por una fuente constante de tensión. En el diagrama se han destacado los 
conectores como pequeños cuadrados azules y blancos. Cada conector corres- 
ponde a un terminal eléctrico, los azules corresponden a los terminales posi- 
tivos y los blancos a los negativos. Las líneas que unen los conectores repre- 
sentan las conexiones; se ha destacado en rojo una de esas conexiones, que 
conecta el terminal positivo de la fuente de tensión con el terminal negativo 
del resistor. 

El archivo rc.mo muestra el código Modelica correspondiente al diagrama. 
Nótese que la sección equation consta de instrucciones connect (), cuya 
función es representar las conexiones entre componentes. La primera de esas 
instrucciones (connect (V.p,R.n) ;) corresponde a la conexión destacada en 
rojo en el diagrama. 
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Diagrama 
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Archivo 3.2 rc.mo 


Ejemplo 3.4: Conectores. 


El diagrama que se presenta a continuación corresponde a uno de los ejem- 
plos de la Modelica Standard Library, que representa el calentamiento de un 
cuerpo a través de una resistencia eléctrica. El modelo utiliza variables de tipo 
eléctrico y térmico. Las conexiones eléctricas se representan en azul, mientras 
que las conexiones térmicas se representan en rojo. 
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Diagrama 
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Las conexiones en un modelo Modelica solo pueden realizarse entre conecto- 
res del mismo tipo. No es correcto conectar, por ejemplo, un conector eléctrico 
con uno térmico. La razón fundamental para esta restricción es que la infor- 
mación asociada a cada tipo de conector es diferente. En los conectores de este 
ejemplo, el tipo de información asociada es la siguiente: 


= En los conectores eléctricos: 


+ Corriente eléctrica (variable de flujo). 


+ Diferencia de potencial eléctrico (variable que no es de flujo). 
= En los conectores térmicos: 


. Flujo de calor (variable de flujo). 


. Temperatura (variable que no es de flujo). 


Un mismo modelo puede tener conectores de diferente tipo; tal es el caso del 
resistor de este ejemplo (heatingRes), que tiene dos conectores eléctricos y 
uno térmico. Con los primeros se conecta al resto del circuito eléctrico, mien- 
tras que con el último se conecta al sistema térmico. 


3.1.2 Orientación 


Modelica es un lenguaje orientado a objetos y, por tanto, comparte algunas 
características comunes con los lenguajes de programación orientados a obje- 
tos”, tales como encapsulamiento, herencia, polimorfismo, etc. (véase sección 


3Vale la pena insistir en que Modelica es un lenguaje de modelado, no de programación. 
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1.2.6). En la práctica, esto significa que es posible definir clases y luego crear 
diferentes instancias de una misma clase, cada una de ellas con propiedades 
especificas. También significa que es posible crear una jerarquía de clases. 

Como elemento particular del lenguaje, se definen clases especializadas, 
que tienen alguna especificación adicional para facilitar el modelado de algu- 
nos componentes. El listado de clases especializadas es el siguiente: 


= model: es el tipo de clase más general. La única restricción consiste en 
que las instancias de estas clases no pueden usarse en conexiones. 


= record: esta es una clase para encapsular propiedades sin compor- 
tamientos. Por tanto, no pueden definirse ecuaciones. 


= type: se utiliza para definir nombres de clases como tipos de dato. 


= connector: esta clase es usada específicamente para definir los conec- 
tores de los modelos. Se utilizan para almacenar información que se 
comparte entre dos componentes que se conectan. No pueden contener 
ecuaciones. 


= block: setrata de una clase en la que la causalidad está predefinida (véase 
sección 3.1.4). Las variables declaradas deben acompañarse del prefijo 
input o output, para declarar la causalidad. 


= function: son clases definidas para modelar el concepto de funciones 
matemáticas. Son semejantes a los bloques, pero no pueden definirse 
ecuaciones; en su lugar, se utilizan algoritmos explícitos o llamados a 
funciones externas. 


= package: se utiliza para organizar espacios de nombres y librerías. Un 
paquete solo contiene declaraciones de clases. 


Ejemplo 3.5: Clases e instancias. 


La Modelica Standard Library incluye un ejemplo que consiste en dos iner- 
cias rotacionales conectadas a través de un sistema de piñones sobre las que 
se aplican dos torques diferentes. El diagrama siguiente corresponde a dicho 
ejemplo: 
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Diagrama 
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En ese diagrama pueden notarse dos componentes semejantes nombrados co- 
mo Inertial y Inertia2. Se trata de dos instancias de la misma clase. El 
archivo LossyGearDemo1.mo corresponde a la implementación del ejemplo. 
Allí puede notarse que los componentes Inertal e Inertia2 son ambos de 
la clase Rotational. Components .Inertia. Cada uno de los componentes 
tiene el atributo J, que adquiere valores diferentes en cada componente (J = 1 
en Inertial y J = 1,5 en Inertia2); en otras palabras, el parámetro J está 
encapsulado en cada una de las instancias. 


Archivo 3.3 LossyGearDemo1.mo 


r 
within Modelica. Mechanics. Rotational.Examples; 
model LossyGearDemol 
extends Modelica.Icons.Example; 
SI.Power PowerLoss = gear.flange_a.tau * der(gear.flange_a.phi) 
+ gear.flange_b.tau * der(gear.flange_b.phi); 
Rotational.Components.LossyGear gear( ratio = 2, lossTable = 
[0,0.5,0.5,0,0]); 
Rotational.Components.Inertia Inertial(J] = 1); 
Rotational.Components. Inertia Inertia2(J] = 1.5); 
Rotational. Sources. Torque torquel(useSupport = true); 
Rotational.Sources. Torque torque2(useSupport = true); 
Modelica. Blocks .Sources.Sine DriveSine(amplitude = 10, freqHz = 1); 
Modelica. Blocks.Sources.Ramp load(height = 5, duration = 2, offset = 
10); 
Rotational.Components. Fixed fixed; 
equation 
connect(Inertial .flange_b,gear.flange_a); 
connect(gear.flange_b ,Inertia2.flange_a); 
connect(torquel.flange ,Inertial.flange_a); 
connect(torque2.flange ,Inertia2.flange_b); 
connect(DriveSine.y,torquel.tau); 
connect(load.y,torque2.tau); 
connect(fixed.flange ,gear.support); 
connect(fixed.flange ,torquel.support); 
connect(fixed.flange ,torque2.support); 
annotation(experiment(StopTime = 0.5, Interval = 0.001)); 
end LossyGearDemol; 
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El modelo también incluye dos instancias denominadas torquel y 
torque2 de la misma clase Rotational.Sources.Torque. Las figuras que 
vienen a continuación muestran el resultado de la simulación para las varia- 
bles w de los componentes Inertial e Inertia2 y para las variables phi de 
los componentes torquel y torque?2. La diferencia en los comportamientos 
ilustra cómo se manifiesta el encapsulamiento de las variables simuladas. 


Inercias.w 


=|nertial.w "== |nertia2.w 
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Ejemplo 3.6: Jerarquía de clases. 


En la Modelica Standard Library se definen varios bloques de funciones ma- 
temáticas. La diagrama UML que se muestra a continuación se refiere a unos 
pocos de esos bloques, que se podrían implementar usando el código del ar- 
chivo bloquesMath.mo. 


La clase SISO se define como un bloque que tiene dos parámetros: u (del ti- 
po Real Input) e y, (del tipo Real0utput). Se trata de un bloque abstracto 
(debido all modificador partial) que engloba a todos los bloques que tienen 
una entrada Real y una salida Real. 


Los bloques Acos, Sin y Log heredan del bloque SISO sus propiedades, y cada 
uno de ellos se especializa en una función, consistente en un cálculo aritmético 
específico. En el código Modelica la herencia se denota por la palabra clave 
extends; en el ejemplo, la especialización se encuentra en el trozo equation 
de cada modelo. 


Diagrama UML 


RealInput u 


Real0utput y 


Código 


Archivo 3.4 bloquesMath.mo 


partial block SISO 
RealInput u; 
RealOutput y; 
end SISO; 


block Sin 


extends SISO; 
equation 
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y=sin(u); 
end Sin; 


block Acos 
extends SISO; 
equation 
y=acos(u); 
end Acos; 


block Log 
extends SISO; 
equation 
y=l0g (u); 
end Log; 


3.1.3 Multidominio 


Modelica es un lenguaje de propósito general, en el sentido de que permite 
modelar sistemas de dominios físicos diversos. Por dominio entendemos aquí 
las distintas ramas de la ciencia y la tecnología, tales como biología, química, 
electricidad, mecánica, hidraúlica, redes, etc. 

Existen herramientas de software para simular fenómenos de cada uno 
de esos dominios* que se apoyan en lenguajes diseñados para describir di- 
chos fenómenos. Estos lenguajes, no obstante, difícilmente pueden describir 
fenómenos de otros dominios, y por tanto las capacidades de simulación que- 
dan necesariamente circunscritas a su dominio específico. 

En su lugar, Modelica ha sido concebido para permitir el modelado y si- 
mulación de fenómenos multidominio. Un mismo modelo Modelica puede, 
por ejemplo, integrar fenómenos eléctricos, mecánicos y térmicos. La orien- 
tación a objetos permite construir jerarquías de clases a partir de definiciones 
muy generales hacia otras más específicas. Por esta razón, los modelos Mode- 
lica pueden a la vez: 


= Ser tan fáciles de emplear como los modelos diseñados para herramien- 
tas de dominio específico. 


= Tener la versatilidad necesaria para construir modelos multidominio. 


%Tales como Orcad-PSpice para circuitos eléctricos (véase [Cad16]) o Aspen para procesos químicos 
(Véase [Asp16])). 
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Ejemplo 3.7: Multidominio. 


Considérese el problema abordado en [BS03]. Se desea construir y simular 
un modelo de un circuito de control de temperatura; el elemento cuya tem- 
peratura se desea controlar es una barra cilíndrica de aluminio. Los autores 
proponen el uso de Pspice como herramienta de diseño y simulación. 


Debido a que Pspice es una herramienta de simulación de circuitos eléctri- 
cos, el modelo que se debe construir solo puede incluir elementos eléctricos. 
Sin embargo, el sistema contiene fenómenos térmicos y elementos de control. 
En consecuencia, es necesario construir modelos eléctricos equivalentes a los 
fenómenos no eléctricos: 


= Para analizar el calentamiento en la barra de aluminio, esta se modela 
en seis secciones. En cada sección el modelo de transferencia de calor y 
calentamiento, se traduce a un circuito con resistores y capacitores. 


= Los fenómenos de temperaturas constantes se traducen a fuentes de ten- 
sión constantes. 


= El fenómeno de radiación de calor se traduce, en un primer modelo, a 
una fuente de corriente de potencia constante y, en un segundo modelo, 
a un bloque ABM (Analog Behavioral Modeling), es decir, como fuente 
controlada. 


= La potencia entregada por el actuador (una resistencia eléctrica) se tra- 
duce a una fuente de voltaje que alimenta el circuito térmico. 


= El sensor de temperatura (un puente de Wheatstone con un par de ter- 
mistores) se traduce a una combinación de bloques ABM y una tabla de 
interpolación lineal. 


= El controlador proporcional se traduce a un circuito basado en un am- 
plificador operacional. 


En contraste, considérese el controlador de temperatura que se incluye co- 
mo ejemplo en la Modelica Standard Library, y cuyo diagrama se muestra a 
continuación: 
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El modelo corresponde a un sistema diferente al analizado en [BS03], pero 
es adecuado para ilustrar la naturaleza multidominio de Modelica. El modelo 
incluye componentes eléctricos, térmicos, de procesamiento de señales y de 
control, cada uno de ellos modelado dentro de su dominio. Además, en un 
mismo componente se pueden modelar fenómenos de varios dominios. Tal es 
el caso de la resistencia eléctrica que calienta el sistema, en la que se simulan 
fenómenos eléctricos y térmicos acoplados. 


3.1.4 Acausalidad 


En el contexto de la simulación numérica, un modelo es causal si es posible 
clasificar de antemano las variables que definen su comportamiento como va- 
riables de entrada (conocidas) y de salida (por conocer). 

Modelica permite definir modelos con relaciones causales y acausales. 
Para diferenciar unas de otras se utilizan dos operadores diferentes: 


= El operador de igualdad = que establece relaciones acausales: 


La expresión z=x+y; establece una relación acausal entre las tres varia- 
bles x, y, z. Cuando esta expresión se utilice en una simulación, dos de las 
variables se utilizarán para calcular la tercera. No obstante, no es posi- 
ble saber de antemano qué papel cumplirá cada variable. De hecho, esto 
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deberá determinarse en el momento de la compilación, utilizando algún 
algoritmo de ordenamiento. 


= El operador de asignación := que establece relaciones causales: 


La expresión z:=x+y; establece una relación causal entre las tres varia- 
bles x, y, z. Esto significa que el valor de la variable z se calculará como 
la suma de los valores de las variables x, y. 


La acausalidad de Modelica se pone de manifiesto al notar que las siguien- 
tes expresiones son válidas y equivalentes: 


Z2=X+Y; IT+FY=2; Z=Y; Z=Yy=_; 


La acausalidad es fundamental para implementar algoritmos de orde- 
namiento (véase sección 2.4.2). Estos algoritmos no solo ordenan las ecua- 
ciones, sino que establecen qué variables pueden calcularse a partir de cada 
ecuación; en otras palabras, además de ordenar las ecuaciones, establecen la 
causalidad de estas. El compilador debe, entonces, estar en capacidad de des- 
pejar cualquiera de las variables en la ecuación. 

En ocasiones es conveniente predefinir la causalidad de un modelo. Si 
esto es así, es posible emplear los modificadores input y output en la de- 
finición de las variables. El compilador debe reconocer esta condición en el 
algoritmo de ordenamiento. 


Ejemplo 3.8: Acausalidad. 


Considérese el oscilador de Duffing, que es un sistema no lineal definido por 
las ecuaciones 3.1: 


11= 22 
E 3.1 
da= —kx22+ 2127 id 
Este oscilador tiene un comportamiento interesante, entre otras cosas por la 
posibilidad de crear órbitas homoclínicas (véase, por ejemplo, [GH83]), como 
la que se muestra en la siguiente figura, que corresponde a las condiciones 
k=0,£ 100 = 1 2(01==-1. 
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Órbita 


mun X2 VS xl 


Los archivos duffing1.mo, duffing2.mo, duffing3.mo muestran tres posibles 
implementaciones en Modelica del oscilador. 


Archivo 3.5 duffingl.mo 


Archivo 3.6 duffing2.mo 
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Archivo 3.7 duffing3.mo 


model duffing3 

Real x1(start=1); 
Real x2(start=-—1); 
parameter Real k=0; 
equation 

der(x1)=x2; 
x1=kx*x2+x113+der(x2); 
end duffing3; 


J) 


Pese a que las tres implementaciones contienen tres versiones distintas de la 
misma ecuación, el compilador genera para los tres modelos el mismo código 
en lenguaje C. El trozo de este código que corresponde a las ecuaciones del 
modelo es el siguiente: 


ES 
void eqFunction_1(DATA *data) 
1 


modelica_real tmp0; 

tmp0 = $Pxl; 

$PS$DER$Px2 = (((—$Pk) + $Px2) + ($Px1 — (tmp0 * tmp0 * tmp0))); 
) 


void eqFunction_2(DATA *data) 
1 


) 


$PSDER$Px1 = $Px2; 


Ejemplo 3.9: Causalidad. 


Los archivos gTestl.mo y gTest2.mo muestran dos implementaciones seme- 
jantes para un sistema descrito por las ecuaciones simples: 


y= 2u 
y= sin(t) 


En ambas implementaciones se ha definido un bloque que relaciona las varia- 
bles u, y a través de la ecuación y = 2u; también se ha definido un bloque para 
el comportamiento de la variable y = sin(t), y un tercer bloque que conecta 
los dos anteriores. 

La diferencia entre las dos implementaciones, consiste en la adición de los mo- 
dificadores input y output en los dos primeros bloques. Como consecuencia 
de ello, el tercer bloque conecta dos variables de salida. El compilador detecta 
esta situación y arroja un mensaje de advertencia: 
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Warning: Connecting two signal sources 
while connecting G.y to S.y 


Archivo 3.8 gTestl.mo 


Archivo 3.9 gTest2.mo 
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3.1.5 Modelo del tiempo 


En un modelo Modelica, el tiempo se representa como una variable conti- 
nua. El nombre de la variable tiempo es time, y la función der () representa 
la derivada respecto al tiempo. Al realizar una simulación numérica time se 
discretiza, de acuerdo con el método de integración utilizado. 

No obstante, también es posible construir modelos discretos. Para ello, 
Modelica utiliza el concepto de evento. Un evento es algo que ocurre (véase 
sección 2.5); en la definición del lenguaje Modelica, un evento tiene las si- 
guientes propiedades: 


= Esinstantáneo, su duración en el tiempo es cero. 


= Tiene una condición del evento asociada que debe pasar de falsa a verda- 
dera para que el evento ocurra. 


= Tiene un conjunto de variables asociadas al evento, cuyo valor cambia 
cuando el evento ocurre. 


= Tiene algún comportamiento asociado a través de ecuaciones 
condicionales. 


La función sample(to,dt) está diseñada para facilitar el modelado de 
sistemas discretos de periodo constante. El resultado de la función cambia de 
falso a verdadero periódicamente y, por tanto, puede utilizarse para activar 
periódicamente un evento. El periodo es dt, y el primer cambio sucede en to. 

Gracias al concepto de evento, también es posible construir modelos hí- 
bridos, es decir, que combinen comportamientos continuos y discretos (véase 
sección 2.5). En tiempo de simulación, el método numérico debe integrar las 
variables continuas, y actualizar las variables discretas en los instantes en que 
se activen los eventos. 


Ejemplo 3.10: Modelo discreto. 


La ecuación discreta de primer orden: 
x(k +1) = ax(k) a=0,5 m01=1 (3.2) 


se puede modelar tal como aparece en el archivo discreto.mo. 
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Código 


Archivo 3.10 discreto.mo 


model discreto 
Real x(start=1); 
parameter Real a=0.5; 
equation 
when sample(0,1) then 
x=pre(x)xa; 
end when; 
end discreto; 


Simulación 


tiempo (s) 


La gráfica de arriba muestra el resultado de la simulación. Puede verse que la 
variable x sólo cambia en valores discretos del tiempo. La instrucción when 
detecta en que momento la instrucción sample (0,1) pasa de falso a verda- 
dero, es decir, detecta los valores de t = 1,2,3,... En esos instantes activa la 
instrucción x=pre(x)*a; que implementa la ecuación 3.2. 


M 
Ejemplo 3.11: Modelo híbrido. 


El código del archivo hibrido.mo implementa (en un mismo modelo) un sis- 
tema con dos variables, una continua y otra discreta: 


a=-—1 
b=3 (3.3) 
a(0)1=x2:(0)=T: 


x1(k +1) = axj(k) 
xa(t) = bx1(k)x2(t) 


en la que k representa el tiempo en forma discreta y t en forma continua. 
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Código 
Archivo 3.11 hibrido.mo 


model hibrido 
Real x1(start=1); 
Real x2(start=1); 
parameter Real a=-—1; 
parameter Real b=3; 
equation 
when sample(0,1) then 
xl1=pre(x1)*a; 
end when; 
der(x2)=bx*x1*x2; 
end hibrido; 


Simulación 


mua ] O a 2 
1.5 


0.5 


x1, x2 


-0.5 


tiempo (s) 


La simulación que se presenta arriba permite visualizar el comportamiento 
de las dos variables x1 y 12. La primera de ellas varía de forma discreta y la 
segunda de forma continua. 


3.1.6 Interoperabilidad con lenguajes de programación 


Es posible incorporar en un modelo Modelica relaciones causales escritas en 
lenguajes de programación. Específicamente, es posible utilizar funciones 
externas escritas en lenguaje C o Fortran. 

El compilador debe conocer la ubicación del código fuente de la fun- 
ción externa para poder compilarlo y enlazarlo con el programa de simulación 
principal. Debido a que la mayoría de herramientas de simulación basadas en 
Modelica generan código fuente en lenguaje C como una etapa intermedia 
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en el proceso de simulación (véase sección 4.3), no es necesario instalar un 
compilador adicional para lograr incorporar funciones externas escritas en 
lenguaje C. 

El proceso contrario, es decir, incorporar trozos de código Modelica en 
programas escritos en lenguajes de programación, no está soportado. No obs- 
tante, un programador experimentado quizás pueda realizar ingeniería inver- 
sa sobre el código C que genera el simulador, para incorporarlo en su código. 


Ejemplo 3.12: Funciones externas. 
Supóngase la necesidad de construir un selector de funciones, es decir, una 


función y = f(i,x) = f¡(1) para una colección de funciones f, (1), fo(x),---, 
Fn (1). El archivo selector.mo muestra una implementación de este selector. 


Código Modelica 


Archivo 3.12 selector.mo 


r 


function selector 
input Integer caso; 
input Real x; 
output Real y; 
external ”C” y=ext_selector(caso,x)  annotation(Include=”*include 1” 
extSelector.c1””); 
end selector; 


model selTest 
Real x,y1l,y2,y3; 
equation 
x=sin (time); 
yl=selector(1,x); 
y2=selector(2,x); 
y3=selector(0,x); 
end selTest; 


La función selector recibe dos parámetros: caso y x. La función devuelve 
la variable y, que se calcula en la función externa extSelector () escrita en 
lenguaje C. Esta función se muestra en el archivo extSelector.c y ha sido im- 
plementada utilizando una estructura switch-case. 


Para probar la función se ha diseñado el modelo selTest, que calcula y1, y2, 
y3 con tres llamados diferentes a la función selector, para el mismo valor de 
x=sin(t). El resultado de la simulación se muestra a continuación. 
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Código C 


Archivo 3.13 extSelector.c 


Simulación 


tiempo (s) 


3.1.7 Documentación de los modelos 


Cada modelo Modelica puede contener su propia documentación interna a 
través de la palabra clave annotation. Los dos usos principales de esta capa- 
cidad son: 


= Incorporar una descripción textual del modelo, sus características y for- 
ma de uso. Esta descripción se guarda en formato HTML. 


= Incorporar una descripción gráfica del modelo, en forma de ícono. Esta 
descripción se hace a través de primitivas gráficas propias del lenguaje. 
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Las herramientas diseñadas para la construcción y edición de modelos 
Modelica pueden aprovechar estas dos capacidades de documentación para 
facilitar la labor del modelador. 


Ejemplo 3.13: Documentación textual y gráfica. 


El diagrama del circuito RC del ejemplo 3.3 se ha obtenido con la herramien- 
ta gráfica OMEdit utilizando el código del archivo rcOMedti.mo. Las instruc- 
ciones annotation se han utilizado para definir los elementos gráficos del 
modelo. 


Código Modelica 


Archivo 3.14 rcOMedit.mo 


within Modelica. Electrical. Analog; 
model rc 
Basic.Ground G annotation(Placement(visible = true, transformation ( 
origin = [—60,—5), extent = (([—12,-—12),(12,12)), rotation = 0))) 


annotation (Diagram ()); 


Sources. ConstantVoltage V(V = 12) annotation(Placement( visible = true 
, transformation(origin = [(—60,35), extent = 
1(-12,12),(12,—12)), rotation = —90))); 


Basic. Capacitor C(C = 0.000001) annotation(Placement( visible = true, 
transformation(origin = (0,35), extent = ((12,—12),(-—12,12)), 


rotation = —270))); 

Basic. Resistor R(R = 10) annotation (Placement( visible = true, 
transformation(origin = (—35,60), extent = ((12,12),(—12,-—12)), 
rotation = —180))); 

equation 


connect(V.p,R.n) annotation(Line(points = 
[1 —60,47),[—60,60),[ —47,60)))); 
connect(R.p,C.n) annotation (Line( points 1(-23,60),[0,60),(0,47)))); 
connect(V.n,C.p) annotation (Line(points 11 -60,23),(0,23)))); 
connect(V.n,G.p) annotation(Line(points = [((—60,23),[—60,7)))); 
end rc; 


Il 


3.1.8 Reusabilidad 


Modelica ha sido diseñado para potenciar la reutilización de componentes. La 
orientación a objetos, la acausalidad y el modelo de componentes-conectores 
son la columna vertebral del lenguaje que lo permite. 

En la práctica, esta característica se manifiesta en la existencia de libre- 
rías de componentes. En [Ass07] se puede consultar una amplia colección de 
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librerías, tanto comerciales como libres. Entre de estas librerías se destaca la 
Modelica Standard Library, que se presenta en la sección 3.3. 

No todas las librerías, sin embargo, son 100% funcionales. No es ex- 
traño encontrar en la red librerías que han perdido vigencia, debido a los 
cambios en las especificaciones del lenguaje al pasar de una versión a otra. 
También es usual encontrar librerías que solo funcionan adecuadamente 
con algunas herramientas de simulación”. 


Ejemplo 3.14: Librerías. 


El archivo osciladores/package.mo muestra la implementación de una librería 
de osciladores. La instrucción package empaqueta las definiciones. La librería 
tiene una modelo abstracto oscilador, y tres modelos herederos especializa- 
dos para implementar el oscilador lineal, el oscilador de Duffing y el oscilador 
de Van der Pol (véase [GH83]). 


El archivo oscTest.mo es un modelo para probar la librería. Contiene tres osci- 
ladores diferentes (uno de cada modelo de la librería), cuyo comportamiento 
se muestra en los retratos de fase de abajo, obtenidos a partir de la simula- 
ción. Obsérvese el uso de la sintaxis osciladores .X para referirse al modelo 
X incluido en la librería osciladores. 


Paquete 


Archivo 3.15 osciladores/package.mo 


> 
package osciladores 


partial model oscilador 
Real tarios 
Real (start=los 

equation 
der(x1)=x2; 

end oscilador; 


model lineal 
extends oscilador; 

equation 
der(x2)=-x1; 

end lineal; 


model duffing 
extends oscilador; 


Para los usuarios de OpenModelica (véase capítulo 4), es desafortunado que no todas las librerías 
disponibles se puedan compilar adecuadamente con el compilador omc (véase sección 4.4). En [Con07] 
puede verse el análisis de compatibilidad de una amplia colección de librerías respecto a OpenModelica. 
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Modelo 


Archivo 3.16 oscTest.mo 


Retratos de fase 


mos Lineal mw Duffing "ww Vanderpol 


3.2 ALGUNOS ELEMENTOS DEL LENGUAJE 


En esta sección se presentan algunos elementos del lenguaje que pueden ayu- 
dar a ilustrar su potencial de descripción, y que no han sido presentados en 
los ejemplos de la sección 3.1. Tales elementos son: 


a. Tipos de datos: las definiciones de los tipos de datos son más ricas que las 
usuales en lenguajes de programación. El tipo de dato Real, por ejemplo, 
es en realidad una clase que tiene los siguientes atributos: 
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= value: es el valor en punto flotante de doble precisión de la variable. 


= quantity: nombre de la cantidad física que representa; por ejemplo 
“Longitud”. 


= unit: unidades en que se mide la cantidad; por ejemplo “m”. 


= displayUnit: unidades utilizadas para desplegar información; por 
ejemplo “km”. 


= min: valor mínimo que puede tomar la variable. 
= max: valor máximo que puede tomar la variable. 
= start: valor inicial fijo o candidato?. 


= fixed: valor booleano que especifica si el parámetro start es un va- 
lor inicial fijo o candidato. 


= nominal: valor nominal de la variable. 


stateSelect: variable auxiliar para diferenciar estados. 


Adicionalmente, la definición de Real incluye dos ecuaciones del tipo 
assert que sirven como alertas que se activan cuando el valor de la va- 
riable está por fuera de los límites establecidos por los atributos min y max. 


De forma semejante, los tipos de datos Integer, Boolean y String son 
clases con atributos. La clase especializada type permite, además, definir 
nuevos tipos de datos que enriquecen el lenguaje. 


Arreglos de datos: en la terminología de Modelica se utilizan cuatro desig- 
naciones diferentes para referirse al concepto de arreglo de datos: 


Escalares: datos simples. 


Vectores: matrices unidimensionales. 


Matrices: matrices bidimensionales. 


Arreglos: matrices con k dimensiones (k > 0). 


El lenguaje es rico en instrucciones para manipulación de arreglos”. Cuenta 
con funciones que permiten: 


= Declarar, dimensionar y redimensionar arreglos. 


= Gestionar los datos en los arreglos. 


Candidato para obtener un conjunto de condiciones iniciales consistente. 
7 Aunque no es un lenguaje orientado a matrices, como pueden serlo los lenguajes Matlab o Scilab. 
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= Aplicar operaciones sobre los datos de los arreglos. 
= Operar arreglos entre sí. 


= Aplicar operaciones algebraicas sobre los arreglos. 


c. Ecuaciones condicionales e iterativas: en Modelica las ecuaciones definen 
las relaciones entre las variables, por ejemplo, a través de la instrucción 
connect (). En ese sentido, están estrechamente relacionadas con la es- 
tructura del modelo. 


En Modelica es posible modelar ecuaciones, es decir conexiones de com- 
ponentes, apoyados en estructuras del tipo for, if-then-else, while, 
when. Esta propiedad permite construir modelos cuya estructura se decide 
en línea mediante iteraciones, condicionales o eventos, lo que incrementa 
la flexibilidad descriptiva del lenguaje. 


3.3 La MODELICA STANDARD LIBRARY 


La Modelica Standard Library es un paquete desarrollado y mantenido por la 
Modelica Association. Contiene la definición de un conjunto amplio de cons- 
tantes, unidades, funciones, tipos, conectores, modelos parciales, modelos y 
ejemplos de componentes. 

La librería se distribuye de forma libre con un licenciamiento establecido 
por la Modelica license. El propósito de este licenciamiento es: 


[...] que las librerías de modelos, software, imágenes, documentos, 
archivos de datos, etc. puedan ser usados libremente en su forma 
original o en una forma modificada, en ambientes de código abier- 
to y en ambientes comerciales. (véase [Ass25b]). 


La tabla 3.1 muestra el conjunto de paquetes y subpaquetes incluidos en 
la versión 3.2.1. de la Modelica Standard Library. Para elaborar la tabla se han 
tomado solamente los tres primeros niveles de complejidad del árbol de la li- 
brería. El número de clases, registros, modelos, etc., varía de un paquete a otro. 
Para tener una idea del tamaño de la librería, considérese que se trata de una 
colección de archivos de texto plano, cuyo tamaño es de cerca de 30Mb. 
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Tabla 3.1 Paquetes y subpaquetes de la Modelica Standard Library 


Continuous Internal 
Discrete 
Examples BusUsage_Utilities 
Icons 
Interaction Show 
Interfaces Adaptors 
Logical 
Blocks Math UnitConversions 
MathBoolean 
MathInteger 
Nonlinear 
Routing 
Sources 
Tables 
Types 
ComplexMath 
ComplexBlocks SEA 
Interfaces 
Sources 
ComplexMath Vectors 
Constants 
Basic 
Examples 
Ideal 
nales Interfaces 
Lines 
Semiconductors 
Sensors 
Sources 
Basic 
Converters 
Delay 
Electrical Examples 
Gates 
Interfaces 
Digital Memories 
Multiplexers 
Registers 
Sources 
Tables 
Tristates 
UsersGuide 
BasicMachines 
Examples 
Icons 
Interfaces 
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Electrical 


Machines 


Losses 


Sensors 


SpacePhasors 


Thermal 


Utilities 


MultiPhase 


Basic 


Examples 


Ideal 


Interfaces 


Sensors 


Sources 


QuasiStationary 


Machines 


MultiPhase 


SinglePhase 


Types 


UsersGuide 


Spice3 


Additionals 


Basic 


Examples 


Interfaces 


Internal 


Semiconductors 


Sources 


Types 


UsersGuide 


Fluid 


Dissipation 


HeatTransfer 


PressureLoss 


UsersGuide 


Utilities 


Examples 


AST_BatchPlant 


ControlledTankSystem 


DrumBoiler 


Explanatory 


HeatExchanger 


Tanks 


TraceSubstances 


Fittings 


BaseClasses 


Bends 


GenericResistances 


Orifices 


Icons 


Interfaces 


Machines 


BaseClasses 


Pipes 


BaseClasses 


Sensors 


BaseClasses 


Sources 


BaseClasses 


Types 
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Fluid 


UsersGuide 


BuildingSystemModels 


ComponentDefinition 


Utilities 


Valves 


BaseClasses 


Vessels 


BaseClasses 


Icons 


Library 


Library2 


Package 


Magnetic 


FluxTubes 


Basic 


Examples 


Interfaces 


Material 


Sensors 


Shapes 


Sources 


UsersGuide 


FundamentalWave 


BasicMachines 


Components 


Examples 


Interfaces 


Sensors 


Sources 


Types 


UsersGuide 


Math 


BooleanVectors 


Icons 


Matrices 


Examples 


LAPACK 


Utilities 


Nonlinear 


Examples 


Interfaces 


Vectors 


Utilities 


Mechanics 


MultiBody 


Examples 


Forces 


Frames 


Icons 


Interfaces 


Joints 


Parts 


Sensors 


Types 


UsersGuide 


Visualizers 


Rotational 


Components 


Examples 


Icons 


Interfaces 
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Mechanics 


Rotational 


Sensors 


Sources 


UsersGuide 


Translational 


Components 


Examples 


Interfaces 


Sensors 


Sources 


Media 


Air 


DryAirNasa 


MoistAir 


SimpleAir 


Common 


OneNonLinearEquation 


ThermoFluidSpecial 


CompressibleLiquids 


Common 


LinearColdWater 


LinearWater_pT_Ambient 


Examples 


SolveOneNonlinearEquation 


TestOnly 


Tests 


TwoPhaseWater 


IdealGases 


Common 


MixtureGases 


SingleGases 


Incompressible 


Common 


Examples 


TableBased 


Interfaces 


Choices 


PartialCondensingGases 


PartialLinearFluid 


PartialMedium 


PartialMixtureMedium 


PartialPureSubstance 


PartialSimpleldealGasMedium 


PartialSimpleMedium 


PartialTwoPhaseMedium 


TemplateMedium 


UsersGuide 


MediumDefinition 


MediumUsage 


Water 


Constantinopolitano 


IF97_Utilities 


IdealSteam 


Standard Water 


Standard WaterOnePhase 


WaterlF97OnePhase_ph 


WaterlF97_R1pT 


WaterlF97_R1ph 


WaterlF97_R2pT 


160 


EL LENGUAJE MODELICA 


WaterlF97_R2ph 
WaterlF97_R3ph 
Media Water WaterlF97_R4ph 
WaterlF97_R5ph 
WaterlF97_base 
WaterIF97_fixedregion 
WaterlF97_pT 
WaterlF97_ph 
Conversions NonSlunits 
Slunits Icons 
UsersGuide 
Examples Utilities 
StateGraph Interfaces 
Temporary 
UsersGuide 
Components 
Examples 
FluidHeatFlow Interfaces 
Media 
Sensors 
Sources 
Thermal Celsius 
Components 
Examples 
HeatTransfer Fahrenheit 
Interfaces 
Rankine 
Sensors 
Sources 
Documentation 
UsersGuide Conventions ModelicaCode 
UsersGuide 
ReleaseNotes 
Examples 
Files 
Internal PartialModelicaServices 
Utilities Streams 
Strings Advanced 
System 
Types 
UsersGuide 
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LA SUITE OPENMODELICA 


La simulación de modelos preparados en lenguaje Modelica requiere el uso 
intensivo de herramientas de software. En [Ass18] se listan varias de estas 
herramientas de compilación, simulación y visualización, algunas de las cuales 
son propietarias y otras son libres. Como parte de la oferta de herramientas li- 
bres, destaca OpenModelica por su grado de maduración, soporte y desarrollo 
permanente. 

OpenModelica nació en el laboratorio de ambientes de programación 
de la Universidad de Linkópings (Suecia), gracias al trabajo pionero de Peter 
Fritzon (véase [Uni18, FE98]). En la actualidad, el Open Source Modelica Con- 
sortium (OSMC) lidera el proceso de desarrollo y soporte de un conjunto 
de herramientas que se distribuyen juntas y que conforman la suite (ver 
[Con08a)). 

En las siguientes secciones se hace una presentación de las principales 
herramientas de la suite que sirven para el desarrollo y simulación de mo- 
delos!. El propósito del capítulo es ilustrar el potencial de uso de la suite 
OpenModelica. Además, en la sección 4.3 se explica cómo es el proceso de 
compilación de modelos Modelica, ya que su comprensión puede facilitar la 
interpretación de algunos de los mensajes de error del compilador y, en ge- 
neral, la tarea de modelado. 


4.1 ARQUITECTURA 


La figura 4.1 muestra el esquema de comunicación entre los diferentes módu- 
los de OpenModelica que operan bajo el esquema cliente/servidor. La función 
de cada uno de ellos es la siguiente”: 


= Manejador de sesión interactiva: interpreta y traslada comandos del sis- 
tema e instrucciones Modelica que permiten la evaluación y simulación 
de modelos, así como la visualización de resultados. Su utilización se ex- 
plica en la sección 4.2. 


= Compilador omc: genera el código binario ejecutable a partir del 
código fuente en lenguaje Modelica. Este sofisticado proceso se expli- 


lEste capítulo no pretende ser un extenso manual de usuario de la suite. Para tener información de- 
tallada sobre el uso de cada una de las herramientas de la suite pueden consultarse [FEPA+13a, Con08b, 
EPA? 13b]. 

2Una descripción extensa de estos módulos se encuentra en [EPA + 13b]. 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


edición /(navegación Manejador de 
para Eclipse sesión interactiva 
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ca en la sección 4.3, mientras que la estructura del módulo se describe 
en la sección 4.4. 


Editor de modelos Editor/navegador 


Optimizador y documentos gráfico de modelos 
OMOptim OMNotebook OMEdit 


Plugin MDT de 


Editor textual de 
modelos 


Ejecución Compilador omc 


Figura 4.1 Interacción de los módulos de la suite OpenModelica. Adaptado de [FPA*13b] 


Ejecución: la ejecución del archivo compilado realmente es responsabi- 
lidad del sistema operativo. En la sección 4.5 se explica este proceso. 


Editor textual de modelos: la construcción del código fuente de forma 
textual puede realizarse a través de cualquier editor de textos conven- 
cional. La suite no provee ningún editor de textos especial. 


Editor de modelos y documentos OMNotebook: permite la elaboración 
de textos simples en los que se pueden insertar bloques de simulación y 
graficación de resultados. La sección 4.6 muestra la forma de utilizarlo. 


Editor/navegador gráfico de modelos OMEdit: se trata de una herra- 
mienta gráfica que permite la edición de modelos Modelica, la navega- 
ción a través de librerías y modelos, y la visualización de resultados de 
simulación. Su utilización se presenta en la sección 4.7. 


Plugin MDT de edición/navegación para Eclipse: Eclipse es un ambien- 
te de desarrollo de software ampliamente utilizado. Este plugin permite 
el desarrollo de modelos Modelica en dicho ambiente, la compilación 
de los modelos y la visualización de los resultados. En la sección 4.8 se 
ilustra su utilización. 


LA SUITE OPENMODELICA 


= Depurador: se utiliza también a través de Eclipse. Para ello se cuenta con 
un plugin adicional. 


= Optimizador OMOptim: herramienta basada en heurísticas para la bús- 
queda de los parámetros de un modelo Modelica que minimicen una 
función objetivo incluida en dicho modelo. 


= Otros módulos: existen otros módulos y desarrollos (aún en consolida- 
ción) que no se han incorporado en la figura 4.1. 


4.2 LA CONSOLA OMSHELL 


La figura 4.2 muestra una captura de pantalla de la consola OMShell. A través 
de esta consola es posible interactuar con el sistema operativo y con el com- 
pilador omc. La tabla 4.1 presenta el listado de los comandos disponibles más 
frecuentemente usados, con una breve descripción de su utilidad?, Dada la im- 
portancia del comando simulate, se ha preparado la tabla 4.2 que muestra los 
argumentos con los que se puede controlar las condiciones de simulación. Pa- 
ra ilustrar el potencial de la consola, a continuación se presentan los ejemplos 
de uso 4.1 a 4.3: 


OMShell - OpenModelica Shell 


rce Modelica Consortium (0SMC) 
d GPL, see www.openmodelica.org 
| Connected to OpenModelica 1.9.0 Beta2 (r14224) 
To get help on using OMShell and OpenModelica, type "help()" and press enter. 


>> 


—_—_ e ——_—_—_—_—_——————— h o 


Figura 4.2 Captura de pantalla de la consola OMShell 


3Para una descripción completa de la sinaxis, los argumentos y el valor retornado de cada comando en 
la tabla, puede consultarse [FPA+13a] (sección 1.3). Una descripción de otros comandos se encuentra en 
las secciones de 2.3. y 2.4.3. de [FPA+13b]. 
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Tabla 4.1 Comandos disponibles más usuales en una sesión interactiva 


Nombre Funcionalidad 

cd Cambia el directorio de trabajo 

clear Borra todas las definiciones de memoria 

clearVariables Borra las definiciones de variables de la memoria 

dumpXMLDAE Exporta información de un modelo a formato XML 

exportDAEtoMatlab Exporta la matriz de incidencia de un modelo en formato legible por 
Matlab 

help Despliega ayuda sobre el uso del compilador omc 

instantiateModel Crea una instancia del código y retorna una cadena con la definición 
plana 

list Retorna el listado de una o todas las clases definidas 

listVariables Retorna el listado de las variables definidas 

loadFile Carga un archivo Modelica 

loadModel Carga un modelo o paquete almacenado en el directorio 
OPENMODELICALIBRARY 

plot Grafica una o más variables simuladas contra el tiempo 

plotParametric Grafica una variable simulada en función de otra 

quit Salida y cierre de la consola 

readFile Lee un archivo 

runScript Ejecuta un script 

saveModel Guarda un modelo 

simulate Traduce un modelo y lo simula (ver tabla 4.2) 

system Traslada una orden al sistema operativo 

timing Evalua una expresión y retorna el tiempo empleado 

type0f Determina de qué tipo es una variable 

val Calcula el valor interpolado de una variable simulada en un instante de 
tiempo específico 


Ejemplo 4.1: Interpretación de comandos Modelica. 


En la consola pueden escribirse directamente comandos en lenguaje Modelica; 

por ejemplo, para definir un arreglo x con los enteros del 1 al 5 puede digitarse: 
>> x:=1:5 

y en la consola se despliega el resultado: 


>> x:=1:5 
(1,2,3,4,5) 


168 


LA SUITE OPENMODELICA 


pueden realizarse operaciones sobre la variable definida: 


>> xx*2 
12,4,6,8,10) 


Tabla 4.2 Principales argumentos del comando simulate 


Argumento Tipo Opcional | Valorpor | Descripción 
defecto 

className TypeName| SI Nombre del modelo a simular 

startTime Real NO 0.0 Tiempo de inicio de la simulación 

stopTime Real NO 1.0 Tiempo de finalización de la simu- 
lación 

number0fIntervals Integer | NO 500 Número de intervalos de tiempo en 
el archivo de resultados 

method String NO “dassl' Método de integración a emplear. 
Ver tabla 4.3 

tolerance Real NO 0.000001 Tolerancia para el método de inte- 
gración 

outputFormat String NO “mat' Formato de salida del archivo de re- 
sultados. Ver sección 4.5.2 

fileNamePrefix String NO dí Prefijo para nombrar los archi- 
vos. Si se omite se asume igual a 
className 

variableFilter dad Filtro para decidir qué variables se 


almacenan en el archivo de resulta- 
dos. Cada variable se separa con '|”. 
El valor por defecto significa alma- 
cenar todas las variables. 


cflags String NO pe Banderas adicionales para el compi- 
lador de C. 

storeInTemp Boolean | NO false Uso del directorio temporal. 

measureTime Boolean | NO false Activa el análisis de desempeño. 


Genera archivos html, xml y svg 
con información sobre el tiempo de 
compilación y ejecución con un re- 
loj en tiempo real. 


Ejemplo 4.2: Definición en línea de modelos Modelica. 


Pueden definirse modelos cortos escribiendo en línea su especificación en len- 
guaje Modelica. Por ejemplo, para modelar un sistema de primer orden sim- 
ple y = —z con la condición inicial x(0) = 1 se puede escribir el siguiente 
modelo: 
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>> model test Real x(start=1);equation der(x)=-x;end test; 
l[test) 


para luego simular su comportamiento: 


>> simulate(test); 


Para conocer el valor de la variable x para el instante de tiempo 0,5, se emplea 
la función val: 


>> val(x,0.5) 
0.6065310076919237 


Mientras que para visualizar el comportamiento de la variable x a lo largo de 
toda la simulación se puede emplear la instrucción plot: 


>> plot(x); 
que arroja como resultado: 


OMPlot - OpenModelica Plot 


Plot1 - x(t) 


Pan  FitinView Save Print [Gridl () LogX [) Log Y 


Plot by OpenModelica 


mx 


time 
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Ejemplo 4.3: Uso de librerías y modelos externos. 


Para cargar la librería Modelica Standard Library se escribe: 
>> loadModel (Modelica) 


Y para cargar un archivo de nombre miarchivo.mo: 


>> loadFile("miarchivo") 


Si la sintaxis es correcta, se desplegará el mensaje true, de lo contrario se in- 
formará la línea y columna del archivo en donde se detectó el error. 


Puede ser conveniente cambiar el directorio de trabajo para facilitar la ubica- 
ción de los archivos que se desean cargar: 


>> cd("nuevodirectorio") 


4.3 EL PROCESO DE COMPILACIÓN 


La figura 4.3 ilustra el proceso típico llevado a cabo en la simulación de un 
archivo Modelica. Puede verse que la misión del compilador omc es la de con- 
vertir el modelo preparado en el lenguaje de descripción Modelica en un nuevo 
código que es escrito en el lenguaje de programación C. Este nuevo código se 
convierte en un programa ejecutable, utilizando un compilador externo de C*. 

Mediante un llamado al sistema operativo, se lanza el programa ejecuta- 
ble. Este programa lee algunas condiciones de simulación desde un archivo 
de entrada, simula el proceso, y guarda los resultados de la simulación en un 
archivo de salida (en la sección 4.5 se presentan más detalles de este proceso). 
De nuevo, mediante un llamado al sistema operativo, se invoca el programa 
de visualización que permite desplegar en forma gráfica los resultados de la 
simulación. 

El código generado en lenguaje C utiliza un conjunto de librerías que se 
instalan en el sistema operativo en el proceso de instalación de OpenMode- 
lica. Estas librerías implementan, entre otras cosas, los métodos numéricos 
de solución de ODEs y DAEs; la tabla 4.3 presenta los métodos de integración 
disponibles en la versión 1.9.0. del compilador omc. Las librerías externas tam- 
bién se encargan de gestionar el proceso general de simulación, así como de la 
lectura y escritura de los archivos de entrada y salida. Algunas de estas librerías 
emplean, a su vez, la librería LAPACK++ (véase [0ST14]). 


4OpenModelica utiliza gcc. 
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I 
Modelo Modelica ==>] Traductor 


le=n=o=o=====- Modelo plano 


Analizador 


le=======-=- Ecuaciones optimizadas 


Generador de código 


I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
z I 
SO Ecuaciones ordenadas " 
I 
I 
I 
I 
I 
I 
I 
I 
| 
I 
| 
I 
I 
I 


A Código C 


Librerías en C HF Compilador de € 


l Y 


Archivo de entrada H——>| Archivo ejecutable H——>=| Archivo de resultados 


A 


Visualización 


Figura 4.3 Proceso de compilación, ejecución y visualización con OpenModelica 


La misma figura 4.3 muestra que la generación de código C requiere una 
serie de etapas intermedias, que se explican a continuación: 


a. Traducción: en esta etapa se extrae la representación de los modelos, cla- 
ses, bloques, conectores, funciones, etc., escritos en lenguaje Modelica para 
generar una colección de ecuaciones (diferenciales, algebraicas y simbóli- 
cas) en forma plana. Al realizar esta traducción, también se construye una 
representación abstracta simbólica de las ecuaciones. 


b. Análisis: la representación abstracta de la colección de ecuaciones permite 
la construcción de la matriz de incidencia, y, a partir de ella, el procesa- 
miento mediante los algoritmos de Tarjan, Rasgadura, Pantelides, etc., para 
establecer una nueva colección de ecuaciones ordenadas. 
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Tabla 4.3 Métodos de integración disponibles en la versión 1.9.0. del compilador omc 


Nombre Orden | Control Control Anotaciones 
depaso | de orden 

dassl 1-5 SI sI Es el método de integración por defecto. Co- 
rresponde al método Adams Moulton con Ja- 
cobiano numérico y búsqueda de intervalo 
raíces 

dasslsteps 1-5 SI SI Es el mismo método dassl, pero ignora 
las definiciones de number0f Intervals y 
stepSize. 

dasslwort 1-5 SI SI dassl; sin búsqueda de intervalo raíces 

euler 1 NO NO Método de euler explícitos. 

rungekutta 4 NO NO Método clásico de Runge-Kutta. 

radaul 1 NO NO Método Radau IIA con un puntos. 

radau3 3 NO NO Método Radau IIA con dos puntos. 

radau5 5 NO NO Método Radau IÍA con tres puntos 

lobatto2 2 NO NO Método de lobatto IIA con dos puntos 

lobatto4 4 NO NO Método de lobatto IIA con tres puntos 

lobatto6 6 NO NO Método de lobatto IIA con cuatro puntos 


c. Optimización: las ecuaciones resultantes se analizan para establecer si es 
posible realizar simplificaciones en ellas, reemplazando expresiones trivia- 
les por formas más compactas. 


d. Generación de código las ecuaciones optimizadas se implementan en len- 
guaje C; también se generan los archivos de compilación (makefile) que 
serán leídos por el sistema operativo con las instrucciones adecuadas de 
compilación. 


El ejemplo 4.4 ilustra la transformación que sufre el código Modelica has- 
ta convertirse en código en lenguaje C. 


Ejemplo 4.4: Traducción de código Modelica. 


El código Modelica del archivo rc.mo implementa un circuito simple RC: 
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Archivo 4.1 rc.mo 


Con el comando LoadFile(” rc.mo'') se carga el archivo en el compilador. 
El comando instantiateModel (rc) muestra el modelo plano del circuito. 
En ese modelo las ecuaciones son las siguientes: 


g.p.v = 0.0; 

assert(1.0 + R.alpha * (R.T_heatPort - R.T_ref) 

>= 0.000000000000001, "Temperature outside scope of model!"); 
R.R_actual = R.R * (1.0 + R.alpha * (R.T_heatPort - R.T_ref)); 
R.v = R.R_actual * R.i; 

R.LossPower = R.v * R.i; 

= R.p.v - R.n.v; 

= R.p.i + R.n.i; 

= R.p.i; 

heatPort = R.T; 

= C.C x* der(C.v); 


“. 
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Después del proceso de optimización y ordenamiento, el sistema DAE queda 
reducido a: 
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R.v=C.v-V.V 
C.i=R.v/R.R_actual 
R.LossPower=R.v*C.i 
der(C.v)=C.i/C.C 


El código en lenguaje C que implementa estas ecuaciones se encuentra dentro 
del archivo rc.c. 


Archivo 4.2 rc.c 


4.4 EL COMPILADOR OMC 


El proceso de compilación de OpenModelica se ejecuta a través del programa 
omc, que puede considerarse como el núcleo de la suite completa. 


4.4.1 Estructura interna del compilador 


De acuerdo con la información disponible en el repositorio del código fuen- 
te (véase [Con08a]), la estructura interna del compilador tiene dos módulos 
principales que agrupan a más de cincuenta submódulos especializados: 
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a. FrontEnd: encargado de traducir el modelo Modelica en un modelo plano. 


b. BackEnd: encargado de la generación del código C a partir del modelo 
plano. 


El módulo BackEnd se subdivide en varios módulos, con las tareas especí- 
ficas que se desarrollan de forma secuencial, y que se relacionan a 
continuación: 


= Análisis y optimización del modelo acausal: 


+ Evaluar y remplazar los parámetros de tipo final y los parámetros 
con la anotación Evaluate=true. 


+ Simplificar las ecuaciones tipo if. 

+ Remplazar los llamados a funciones equal. 

+ Particionar los bloques independientes. 

+ Expandir el operador de derivación der. 

+. Encontrar el orden del sistema (número de estados). 

+ Remplazar los llamados a las funciones edge y change. 
+ Aplanar las ecuaciones de arreglos. 


+ Remover la mayoría de las ecuaciones simples. 
= Causalización del modelo: 


+ Revisar si el sistema es singular. 

+ Aplicar el algoritmo de Pantelides para reducción de orden. 
+ Introducir las funciones inline. 

+ Seleccionar los estados. 


Aplicar el algoritmo de Tarjan para ordenamiento de ecuaciones. 


+ Analizar los componentes fuertemente conectados. 
= Análisis y optimización del modelo causal: 


+ Simplificar el sistema lineal constante. 

+ Simplificar los llamados a la función semiLinear. 
+ Remover la totalidad de las ecuaciones simples. 

+ Encapsular las condiciones when. 


* Aplicar el algoritmo de rasgado de subsistemas. 


= Generación de código C 
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4.4.2 Uso del compilador 


El compilador puede usarse directamente a través de comandos de consola, o 
utilizando el manejador de sesiones interactivas, bien sea con la consola OMS- 
hell o con alguna otra interfaz. El uso directo mediante consola consiste fun- 
damentalmente en la generación del código C de un modelo Modelica, como 
se ilustra en los ejemplos 4.5 a 4.7. 


Ejemplo 4.5: Generación de código C a partir de un archivo simple. 


Supóngase que el archivo test.mo contiene el siguiente código Modelica: 


Archivo 4.3 test.mo 


model test 

Real x(start=1); 
equation 

der(x) = —x; 
end test; 


La ejecución del comando: 


omc +s test.mo 


lanzará el compilador, que generará los siguientes archivos, que estarán listos 
para ser compilados por el compilador de C: 

test.c 

test_functions.c 

test_functions.h 

_test.h 

test_init.xml 

test.makefile 

test.mo 

test_records.c 


Para compilar estos archivos se utiliza el comando: 


make - fÍ test.makefile 


que genera el archivo ejecutable test. 


Ejemplo 4.6: Generación de código C a partir de un archivo que usa 
la librería Modelica. 


Supóngase que el archivo rc.mo contiene el siguiente código Modelica: 
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Archivo 4.4 rc.mo 


within Modelica. Electrical. Analog; 
model rc 
Basic.Ground g; 
Basic. Resistor R(R=10); 
Basic. Capacitor C(C=1e-—6); 
Sources. ConstantVoltage V; 
equation 
connect(V.p, 
connect(R.p 
connect(C.p, 
connect(V.n 
end es 


E) 


El modelo anterior utiliza definiciones de la Modelica Standard Library. Para 
generar el código C de ese modelo, es necesario que el compilador cargue la 
librería. Para ello, se utiliza la instrucción: 


omc +s rc.mo Modelica 


Y para compilar dicho código: 


make -f rc.makefile 


Ejemplo 4.7: Instrucciones Modelica. 


El compilador omc también puede usarse para ejecutar una secuencia de ins- 
trucciones Modelica. Supóngase que el archivo rc.mos (véase ejemplo 4.6) tie- 
ne por contenido las siguientes instrucciones Modelica: 


Archivo 4.5 rc.mos 


loadModel(Modelica); 
loadFile (”rc.mo”); 
simulate(rc); 


Para ejecutar esas instrucciones se utiliza el comando: 


omc rc.mos 


Estas instrucciones permiten la simulación del modelo rc que se define en el 
archivo rc .mo. El compilador cargará la Modelica Standard Library, el archivo 
rc .mo, creará el código C, lo compilará y lanzará el archivo ejecutable. 
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4.5 EJECUCIÓN DEL MODELO COMPILADO 


La figura 4.4 es una versión reducida de la figura 4.3. En esta se destaca que 
el resultado de la compilación es un archivo ejecutable que lee un archivo de 
entrada y genera un archivo de resultados. El nombre del archivo ejecutable 
corresponde al prefijo utilizado en la compilación (argumento fileName- 
Prefix, tabla 4.2)”. En las siguientes secciones se explica la estructura de los 
archivos de entrada y salida. 


l 
Modelo Modelica Traductor 
I | 


I 

ler=ooooo-- Modelo plano 

I Y 

I 

l Analizador l 
l 

: l 
l . 

[e =======-=- Ecuaciones ordenadas 

I Y 

l 

I Optimizador 

| 
l 

1 E da l 
le ========- Ecuaciones optimizadas 

I 

l 

l 

I 

l 

l 

I 


Dice sd 
| / 


Archivo de entrada — Archivo ejecutable 


Visualización 


Archivo de resultados 


Figura 4.4 Interacción de algunos archivos en una simulación de OpenModelica 


5En Windows el nombre toma la extensión .EXE. 
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4.5.1 Archivo de entrada 


El archivo de entrada está escrito en lenguaje XML y tiene dos características 
importantes: 


= El nombre del archivo termina en _init.xml. El inicio del nombre corres- 
ponde al prefijo utilizado en la compilación (argumento file NamePrefix, 
tabla 4.2). 


= La estructura del archivo sigue las definiciones del Functional Mockup 
Interface (FMD(véase [Gro17]). 


El FMI es un estándar para intercomunicar herramientas de simulación 
(véase [Con10, BOA*11]). No es un estándar propietario de una herramienta 
específica. El propósito del estándar es facilitar dos tareas: el intercambio de 
modelos y la cosimulación. 

Una de las definiciones del estándar EMI es el esquema de descripción 
de modelos. OpenModelica lo emplea para construir el archivo de entrada al 
que se refiere la figura 4.4. La información que contiene este esquema es la 
siguiente: 


= Atributos generales del modelo, tales como nombre, número de estados 
continuos, número de eventos, autor, etc. 


= Definición de las variables visibles del modelo. Se trata de una descrip- 
ción detallada de cada variable, que incluye nombre, tipo, valor inicial, 
valores mínimos y máximos, etc. 


= Definición del experimento por defecto, con datos tales como tolerancia 
y tiempo de inicio y parada. 


Ejemplo 4.8: Archivo de entrada. 


El trozo del archivo test_init.xml que corresponde a la ejecución del mode- 
lo del ejemplo 4.2, en el que se describe el experimento por defecto, es el 
siguiente: 


<DefaultExperiment 

startTime = "0.0" 
stopTime = "1.0" 
stepSize = "0.002" 
tolerance = "0.000001" 
solver = "dassl" 
outputFormat  = "mat" 
variableFilter = ".*" /> 
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En ese mismo archivo, el trozo en el que se describe la variable x es: 


<ScalarVariable 
name = "x" 
valueReference = "1000" 
variability = "continuous" isDiscrete = "false" 
causality = "internal" 
alias = "noAlias" 
classIndex = "0" classType = "rSta" 
fileName = "g«lt;interactiveégt;" startLine = "1" startColumn = "12" 
endLine = "1" endColumn = "26" fileWritable = "true"> 


<Real useStart="true" start="1.0" fixed="false" useNominal="false" 
nominal="1.0" min="-1.7976931348623157E+308" 
max="1.7976931348623157E+308" /> 
</ScalarVariable> 


4.5.2 Archivo de resultados 


OpenModelica puede generar archivos de resultados en tres formatos distintos 
(argumento outputFormat en la tabla 4.2): 


= Formato mat: formato binario utilizado por el programa Matlab (véase 
[Mat14])). 


= Formato csv: formato de texto plano que almacena una matriz. Las ca- 
racterísticas del fomato son las siguientes: 
+ El separador es la coma. 
+ Cada línea corresponde a un mismo tiempo de simulación. 
+ Cada columna corresponde a una variable simulada. 
+ La primera línea contiene el nombre de las variables. Cada nombre 


se escribe entre comillas dobles. 


= Formato plt: formato de texto específico para la herramienta de grafi- 
cación plot, incluida en OpenModelica*. Algunas de sus características 
son: 
+ Las primeras líneas son un encabezado descriptivo. 
+ Cada variable almacenada genera un DataSet. 


* Cada DataSet es un conjunto de líneas de texto. 


SUtiliza el proyecto Ptolemy de la Universidad de Berkeley (véase [Dep17]). 
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+ La primera línea de un DataSet describe el nombre de la variables. 


+ Las líneas siguientes de cada DataSet contienen parejas de datos se- 
parados por coma. El primer dato corresponde a la variable tiempo, 
y el segundo a la variable almacenada. 


Ejemplo 4.9: Archivo de resultados en formato csv. 


Al simular el modelo del ejemplo 4.2 con formato de salida csv, se genera el 
archivo test_res.csv. Las primeras filas de ese archivo, correspondientes a 
la primera centésima de segundo de simulación, son: 


"time","x","der(x)", 

OsLs=1l, 
0.002,0.9980019984073524,-0.9980019984073524, 
0.004,0.9960079871985149,-0.9960079871985149, 
0.006,0.9940179539149203,-0.9940179539149203, 
0.008,0.9920318976611787,-0.9920318976611787, 
0.01,0.9900497885986662,-0.9900497885986662, 


Ejemplo 4.10: Archivo de resultados en formato plt. 


Al simular el modelo del ejemplo 4.2 con formato de salida plt, se genera el 
archivo test_res.plt. Las primeras filas de ese archivo, correspondientes al en- 
cabezado, son: 


tPtolemy Plot file, generated by OpenModelica 
tNumberofVariables=3 

tIntervalSize=502 

TitleText: OpenModelica simulation plot 
XLabel: t 


Las primeras líneas del DataSet de la variable x, correspondientes a la primera 
centésima de segundo de simulación, son: 


DataSet: x 

0, 1 

0.002, 0.9980019984073524 
0.004, 0.9960079871985149 
0.006, 0.9940179539149203 
0.008, 0.9920318976611787 
0.01, 0.9900497885986662 


182 


LA SUITE OPENMODELICA 


4.6 EL EDITOR DE MODELOS Y DOCUMENTOS OMNOTEBOOK 


OMNotebook es una herramienta de modelamiento y documentación. En ese 
sentido, es una aplicación del concepto de Literate Programming que consis- 
te en la producción simultanea de código y documentación (véase [Knu84])). 
Utilizando OMNotebook es posible construir un documento (un texto) en el 
que se inserta y ejecuta código Modelica. 

Las capacidades de edición de texto son limitadas en comparación con 
las de los procesadores de texto convencionales. No obstante, la posibilidad de 
incorporar código ejecutable dentro del documento hace que esta herramienta 
sea muy atractiva para el desarrollo de textos interactivos. 

Un documento de OMNotebook es un conjunto de celdas. Una celda es 
un espacio rectangular que ocupa el ancho del documento. Cada celda puede 
ser de dos tipos: 


= Celdas de texto: en estas celdas se puede editar y dar formato (alineación, 
tipo y tamaño de font, etc.) a texto. También se pueden insertar imágenes. 
OMNotebook cuenta con algunas facilidades de dibujo de diagramas. 


= Celdas de entrada de código: en estas celdas se inserta código Modelica e 
instrucciones para el compilador omc. Para que el código sea procesado 
por el compilador, el usuario debe evaluar la celda, bien mediante una 
opción en el menú, o mediante la combinación de teclas Shift + Enter. 


Varias celdas pueden formar un grupo, y los grupos pueden anidarse en- 
tre sí. Además, cada grupo puede expandirse o colapsarse. Esta funcionalidad 
permite la construcción de documentos estructurados (en capítulos, seccio- 
nes y subsecciones, por ejemplo), que se navegan de forma interactiva. La suite 
OpenModelica provee dos textos elaborados sobre OMNotebook: 


a. DrModelica: tutorial sobre el lenguaje Modelica. 


b. DrControl: texto guía para un curso de teoría de control. 


Ejemplo 4.11: OMNotebook. 


La figura 4.5 muestra la apariencia de OMNotebook con una implementación 
del ejemplo 4.2. Se han usado tres celdas de texto y tres celdas de entrada de 
código, intercaladas entre sí. El propósito da cada una de las celdas de entrada 
de código es, respectivamente: 


= Introducir el código Modelica del modelo. 
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= Simular el modelo. 


= Visualizar los resultados. 


OMNotebook: test.onb 


so. U- Bl a ea is CCOEeusvyYo 
Ejemplo de uso de OMNotebook: el modelo: 


model test 
Real x(start=1); 
equation 
der (x) =-x; 
end test; 
(test) 
La simulación: 
simulate(test,stopTime=10); 
[done] 
La visualización: 
plot (x) 
[done] 
Zoom| Pan  FitinView Save Print [Gridl [) LogxX [7 Log Y 


Plot by OpenModelica 
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Figura 4.5 Apariencia de OMNotebook con una implementación del ejemplo 4.2 


4.7 EL EDITOR GRÁFICO OMEDIT 


OMEdit es una herramienta de edición y simulación de modelos Modelica. La 
figura 4.6 muestra las ventanas de la aplicación, que se describen a 
continuación: 
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Figura 4.6 Ventanas de OMEdit 


1. Ventana de librerías: permite la navegación a través del árbol de las libre- 
rías. OMEdit carga por defecto la Modelica Standard Library. El usuario 
puede adicionar otras librerías. 


2. Ventana del diseñador: permite la edición de modelos y la visualización 
de resultados. La figura 4.7 muestra la apariencia de la aplicación en tres 
modos diferentes: 


= Edición gráfica: en este modo, el usuario puede arrastrar modelos 
desde la ventana de librerías y conectarlos entre sí usando una 
herramienta gráfica. También, puede complementar el modelo con 
textos y objetos gráficos, tales como líneas, rectángulos, elipses, 
etc. Este modo permite también la edición de íconos asociados 
al modelo. 


= Edición textual: en este modo, el usuario puede escribir directa- 
mente el código Modelica que define el modelo. 


= Visualización: en este modo, se despliegan las curvas del compor- 
tamiento de las variables simuladas que seleccione el usuario. 


3. Ventana de variables graficadas: muestra el árbol de todas las variables 
simuladas, para permitir que el usuario seleccione las que desea graficar. 
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4. Ventana de navegación del modelo: muestra el árbol de los componentes 
del modelo, con información específica de cada uno de los parámetros. 


5. Ventana de mensajes: despliega los mensajes provenientes de la aplicación 
o del compilador. 


Ejemplo 4.12: OMEdit. 


La figura 4.7 muestra la apariencia de OMEdit para una implementación del 
modelo del ejemplo 4.4. El modelo se ha construido usando el modo gráfi- 
co; las coordenadas se han ajustado en modo de texto; se han visualizado dos 
variables simultáneamente: la corriente en la resistencia y la diferencia de po- 
tencial en el condensador. 
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Figura 4.7 Apariencia de OMEdit con una implementación del ejemplo 4.4 
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4.8 EL PLUGIN PARA MDT ECLIPSE 


Eclipse es un plataforma modular de desarrollo de software (véase [Fou18]). 
Inicialmente fue concebida como un ambiente de desarrollo de programas en 
lenguaje Java; no obstante, su modularidad le permite utilizar plugins para 
adecuar la plataforma a diferentes lenguajes de programación”. 

La suite OpenModelica incluye el plugin Modelica Development Toolkit 
(MDT) que facilita el desarrollo de modelos Modelica. Específicamente provee 
las siguientes funcionalidades (véase [EPA* 13a]): 


= Navegación a través de árboles de proyectos, paquetes y clases. 
= Asistentes para la creación de proyectos, paquetes y clases. 

= Resaltado de sintaxis en colores. 

= Revisión de sintaxis. 


= Navegación a través del árbol de la Modelica Standard Library y otras 
librerías. 


= Asistente para escritura de nombres de clases, tipos y funciones. 
= Enlaces a la definición de clases, tipos y funciones. 


= Despliegue de información sobre el tipo de dato de variables y 
parámetros. 


= Despliegue de la consola Modelica. 


Ejemplo 4.13: El plugin MDT para Eclipse. 


La figura 4.8 muestra la apariencia de Eclipse para una implementación del 
modelo del ejemplo 4.2 usando el plugin MDT. El modelo se ha escrito en el 
editor de texto; para compilar el modelo se ha abierto una consola Modeli- 
ca que se comunica con omc; la visualización se ha efectuado mediante un 
llamado a la instrucción plot desde esa misma consola. 


7El plugin para Modelica tiene algunas dificultades de operación en sistema operativo Linux. La defi- 
nición de las variables de ambiente OPENMODELICAHOME y OPENMODELICALIBRARY soluciona algunas de 
ellas. Una buena combinación de trabajo consiste en utilizar eclipse-mdt para editar los modelos y OMShell 
para simularlos. 
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Figura 4.8 Apariencia de eclipse con una implementación del modelo del ejemplo 4.2 


4.9 OTROS MÓDULOS Y DESARROLLOS 


El desarrollo de la suite OpenModelica es permanente. Dentro de las herra- 
mientas disponibles hay varias que no son de utilidad directa para el presente 
documento, o que no han alcanzado aún un grado de maduración suficiente. 


Algunas de ellas son: 


= La herramienta de optimización OmOptim: herramienta independien- 
te que utiliza heurísticas para optimizar modelos. El enfoque consiste 
en buscar cuál es el valor de algunos parámetros seleccionados por 
el usuario que minimizan alguna función objetivo incorporada en el 
modelo. En la actualidad sólo se ha incorporado la heurística de algorit- 
mos genéticos. 


= La interfaz para python OmPython: manejador de sesiones interacivas 
escrito en lenguaje python. Permite llamar desde un programa python 
al compilador omc. 


= Depuración con ModelicaML: utilizando las opciones de depuración del 
compilador de C, se puede hacer un rastreo de la evolución de las varia- 
bles del modelo, incluida la pila del sistema. El método, no obstante, es 
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dispendioso. El plugin MDT GDB para eclipse, facilita en algo la depura- 
ción. Este plugin funciona sobre un conjunto extendido de instrucciones 
denominado ModelicaML. 


Simulaciones interactivas: las simulaciones interactivas permiten modi- 
ficar parámetros del modelo en tiempo de ejecución. El compilador omc 
puede generar ejecutables con esta funcionalidad. 


Cosimulación con la interfaz FMI: la cosimulación consiste en la si- 
mulación de un sistema complejo a través de la simulación de sus 
componentes por diferentes herramientas de software que trabajan de 
manera coordinada. El estándar Functional Mockup Interfaz (FMI) se ha 
desarrollado con ese propósito. OpenModelica tiene un desarrollo in- 
cipiente de cosimulación, que consiste en la adecuación de sus archivos 
de entrada al estándar (ver sección 4.5.1). 


Parte II 
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LABORATORIOS VIRTUALES. 
ESTADO DEL ARTE 


En este capítulo se hace un compendio de algunos aspectos importantes aso- 
ciados a los laboratorios virtuales a partir de una revisión de la literatura 
técnica disponible. Para ello, la sección 5.1 enumera las principales caracte- 
rísticas asociadas al término genérico laboratorio virtual; estas características 
sirven para proponer una clasificación en la sección 5.2; en la sección 5.3, 
por su parte, se discute la importancia de la experimentación en el proceso 
de aprendizaje de la ingeniería, mientras que en la sección 5.4 se destacan 
algunos aspectos a tener en cuenta en el diseño de laboratorios virtuales. 


5.1 CARACTERÍSTICAS DE LOS LABORATORIOS VIRTUALES 


En general, y en un sentido amplio, el término laboratorio virtual se usa para 
referirse a una amplia variedad de soluciones de hardware y software que per- 
miten realizar experimentos sobre modelos matemáticos de la realidad 
([SOHA 12]). No obstante, en ocasiones se emplea el término también para 
referirse a la manipulación remota de elementos físicos presentes en un labo- 
ratorio real (p. ej., en [GR09] y [AKB*01]). 

En medio de la heterogeneidad de los laboratorios virtuales reportados 
en la literatura, es posible identificar algunas características que distinguen a 
unos de otros, las cuales se exponen a continuación. 


5.1.1 Orientación a la web 


Para algunos autores, la disponibilidad en la web es una característica intrínse- 
ca de los laboratorios virtuales (p. ej., [SDGL10]), mientras que otros autores 
utilizan el término para referirse también a soluciones autónomas o de escri- 
torio (p. ej., [Mar07]). 

Un laboratorio orientado a la web está disponible a través de internet. 
Generalmente el usuario accede a él a través de navegadores convencionales. 
Por el contrario, el laboratorio autónomo (stand-alone) se instala directamente 
en el equipo del usuario. La figura 5.1 ilustra los dos enfoques. Las diferencias 
más notorias entre los dos casos son: 


= La infraestructura física necesaria para implementar una solución orien- 
tada a la web es claramente mayor. No obstante, los servicios web hoy 
disponibles en forma directa o a través de terceros suelen facilitar el ac- 
ceso físico a internet. 
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= La complejidad de las soluciones orientadas a la web suele ser mayor, ya 


que requiere de servicios adicionales de comunicación, balance de carga, 
gestión de seguridad, entre otros. 


Como consecuencia de lo anterior, los tiempos de desarrollo y los re- 
cursos necesarios para instalación, soporte, mantenimiento y evolución 
de las soluciones orientadas a la web suelen ser considerablemente 
mayores. 


Las soluciones autónomas en ocasiones son desarrolladas para un único 
sistema operativo, o pueden estar sujetas al uso de otras herramientas de 
software que deben instalarse en el equipo. Esto impone unas exigencias 
al equipo del usuario. Por el contrario, las soluciones orientadas a la web 
por lo general emplean del lado del usuario navegadores web convencio- 
nales ampliamente disponibles. 


La disponibilidad del laboratorio tiene dos escenarios diferentes: el la- 
boratorio autónomo está tan disponible como el equipo donde está ins- 
talado, mientras que la disponibilidad del laboratorio orientado a la web 
está determinada por el acceso a un equipo conectado a internet. 


Los tiempos de respuesta de los laboratorios autónomo son menores, ya 
que en las soluciones orientadas a la web hay que sumar los tiempos de 
comunicación y de respuesta del servidor web a los tiempos propios de 
la simulación. 


a) Laboratorio orientado a la web b) Laboratorio autónomo 


e 2 22 


22 
282 c2 


22 e 


Figura 5.1 Orientación de laboratorios virtuales! 


¡Construida a partir de tres íconos distribuidos con licencia de Creative Commons disponibles en 


[link:2], [link:3] y [link:4]. 
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Existe también un tipo de laboratorio que combina elementos de los dos 
enfoques. Se trata de laboratorios conectados a redes locales, que se operan 
desde equipos fijos. Una de las aplicaciones de este enfoque c aislaonsiste en al 
usuario de situaciones peligrosas. El esquema usual consta de un laboratorio 
real, altamente instrumentado para ser operado parcial o totalmente desde 
una sala de control local. Comparte con el enfoque orientado a la web muchas 
de las necesidades de infraestructura y gestión, pero no es accesible a través de 
internet. 


5.1.2 Naturaleza de los modelos 


En algunos laboratorios virtuales los experimentos se realizan sobre plantas 
físicas, mientras que en otros se realizan sobre modelos de software. Para dis- 
tinguirlos, en este documento se empleará la convención de algunos autores, 
que denominan a los primeros laboratorios como remotos y virtuales a los se- 
gundos ([AN11, SOHA12, GRO09]). Las siguientes son algunas de las diferen- 
cias más evidentes: 


= Los laboratorios remotos requieren, además de la planta en sí, un con- 
junto de instrumentos y actuadores. Usualmente requieren también trans- 
misión de video desde el laboratorio hacia el usuario final. Esta sofisti- 
cación los hace más costosos, tanto para su implementación como para 
su mantenimiento y gestión. 


= Los modelos de software pueden ser accedidos simultáneamente por va- 
rios usuarios y, por tanto, se pueden efectuar varios experimentos dife- 
rentes a la vez; por el contrario, una planta física solo puede usarse a la 
vez en un único experimento. 


= El usuario de los laboratorios remotos realiza experimentos que suelen 
estar prediseñados y no tiene oportunidad de modificarlos. Esto es así 
porque la planta física está preparada para un uso, y es difícil darle flexi- 
bilidad para reconfigurarla a través de la instrumentación que se opera 
remotamente. Por el contrario, los modelos de software pueden desarro- 
llarse con una alta flexibilidad. Además, el usuario puede eventualmente 
acceder al código fuente para modificar el experimento completamente. 


= Los modelos de software reflejan una fracción de la realidad: aquella que 
está incluida en el modelo matemático subyacente. Esto significa que 
muchos aspectos de la experimentación sobre plantas físicas no se ve- 
rán reflejados en el laboratorio virtual. 
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= Las exigencias en el canal de comunicación son mayores para los labora- 
torios remotos. Un tiempo de retardo importante o muy variable puede 
hacer que la usabilidad del laboratorio se vea desmejorada, que se afecte 
la seguridad de la planta o, simplemente, que se arruine el experimento. 
Por el contrario, el impacto de estos retardos en los laboratorios virtuales 
se limita a la usabilidad. 


5.1.3 Dominio de los experimentos 


Las herramientas de software que sirven de soporte de simulación a algunos 
laboratorios virtuales están diseñadas para trabajar con modelos de un úni- 
co dominio físico, ya sea eléctrico, mecánico, químico, biológico, etc. (p. ej., 
[RET+09, SYLLO2]), mientras que otras permiten la simulación de problemas 
multidominio (ver p. ej., [TWJH12, MUDO8]). Aun cuando se utilicen herra- 
mientas multidominio, la interfaz desarrollada puede limitar su uso a un único 
dominio ([SOHA 12, UMDO5, SZaZ11]). 
Como diferencias entre estos enfoques, pueden señalarse las siguientes: 


= Las herramientas de simulación de dominio específico suelen tener APIs 
e interfaces gráficas que utilizan las convenciones y los usos propios de 
la disciplina en la que se aplican. Por esta razón, el desarrollo de aplica- 
ciones tales como laboratorios virtuales puede ser más rápido y eficiente 
que si se desarrollaran estos con herramientas multidominio. 


= Por la misma razón anterior, el desarrollo de los modelos que se- 
rán simulados suele ser más rápido al usar herramientas de dominio 
específico. 


= El desarrollo de herramientas multidominio requiere un grado de gene- 
ralización mayor que el de las herramientas de dominio específico. Por 
esta razón, los algoritmos de compilación y simulación pueden ser más 
lentos y menos eficaces. 


= El tipo de experimentos que se pueden llevar a cabo con herramientas 
multidominio es más rico y por tanto más cercano a la realidad. La com- 
binación de elementos de varios dominios brinda una perspectiva de 
aprendizaje que facilita la integración de conocimientos. 


5.1.4 Interactividad 


De acuerdo con las opciones de interacción que tiene el usuario con los pará- 
metros de la simulación, pueden identificarse los siguientes casos ([Mar07]): 
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= Sin interactividad: los valores de los parámetros no pueden ser modifi- 
cados por el usuario. 


= Deinteractividad discontinua: los valores de algunos parámetros pueden 
modificarse antes de correr la simulación. 


= De interactividad continua: los valores de algunos parámetros pueden 
modificarse antes de correr la simulación o mientras esta se ejecuta. 


Las diferencias más evidentes según el grado de interactividad son las 
siguientes: 


= La complejidad de la implementación se incrementa conforme se incre- 
menta la interactividad. Es decir, los laboratorios sin interactividad son 
menos complejos que los de interactividad discontinua, y estos a su vez 
presentan una complejidad menor que los laboratorios de interactividad 
continua. 


= La interactividad continua es especialmente útil en el entrenamiento del 
uso de equipos, pues allí se puede simular el efecto de cambiar los puntos 
de operación de sistemas en funcionamiento. 


5.1.5 Función del laboratorio 


Los laboratorios no virtuales suelen tener tres posibles funciones: 


= Docencia: el laboratorio se concibe como un espacio de aprendizaje y se 
enfoca en estudiantes. 


= Investigación: el laboratorio se concibe como un espacio para descubrir 
nuevo conocimiento y se enfoca en grupos de investigación. 


= Servicios: el laboratorio se concibe como un espacio para brindar servi- 
cios tales como evaluar muestras o productos, enfocándose en el cliente. 


No es extraño que un mismo laboratorio no virtual pueda atender más de 
una de esas funciones. Sin embargo, los experimentos de docencia, investiga- 
ción y servicios tienen características y exigencias diferentes. En los laborato- 
rios virtuales esto se traduce en modelos con requerimentos muy diferentes: 


= Los requerimientos de seguridad para el acceso a los datos son bajos para 
docencia, medios para investigación y altos para servicios. En este último 
caso, la confidencialidad de la información puede ser un aspecto crítico. 
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= Mientras que los experimentos para docencia y servicios pueden ser re- 
lativamente repetitivos, la flexibilidad en la configuración de los experi- 
mentos puede ser un requisito funcional para investigación. 


= Algunos laboratorios virtuales orientados a investigación permiten la in- 
teracción de grupos de instituciones de diversos países. Estos laborato- 
rios deben brindar la posibilidad de conducir experimentos de forma 
colaborativa, donde los usuarios tengan acceso a los resultados de los 
experimentos realizados por otros usuarios ([SS11]). 


5.1.6 Disponibilidad de los modelos 


La posibilidad de acceder a los modelos matemáticos y al código fuente de 
su implementación en software no es igual para todos los laboratorios virtua- 
les. El acceso a una buena documentación que explique las relaciones mate- 
máticas de los modelos es necesario para poder hacer análisis profundos de 
los fenómenos simulados. Por otra parte, disponer del código fuente y de las 
herramientas necesarias para su interpretación o compilación es condición in- 
dispensable para modificar los modelos y adecuarlos a nuevas situaciones. 


5.1.7 Integración con LMS y compatibilidad SCORM 


Los Sistemas de Administración de Aprendizaje (LMS, por sus sigla en inglés) 
son aplicaciones web que permiten la publicación de cursos en internet, así 
como el acceso de los estudiantes a tales cursos. En este contexto, la iniciativa 
SCORM (Sharable Content Object Reference Model) ha generado una serie de 
especificaciones que permiten reutilizar los objetos de aprendizaje en entornos 
LMS ([Dua09]). 

Los experimentos virtuales pueden asimilarse a objetos de aprendizaje. 
Por esta razón, es interesante analizar el nivel de integración con sistemas LMS 
que tienen los laboratorios virtuales, particularmente aquellos orientados a 
docencia. Estos niveles de integración pueden ser: 


= Sin integración: el laboratorio no contempla la integración con LMS. 


= Enlazables dentro de contenidos SCORM: los experimentos específicos 
pueden enlazarse de forma íntegra y ordenada dentro de objetos de apren- 
dizaje que cumplen la especificación SCORM. 


= Generadores de contenidos SCORM: el laboratorio genera contenidos 
exportables que cumplen la especificación SCORM (p. ej. [JPRO8], 
[RGLC12)). 
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= Integrados en LMS: el laboratorio se integra con uno o más LMS para fa- 
cilitar la administración de tareas, notas, foros, etc. (p. ej. []APRRHF12])). 


5.1.8 Licenciamiento y acceso 


Los aspectos de licenciamiento y acceso deben analizarse desde varias 
perspectivas: 


= El licenciamiento del laboratorio en sí mismo. 


= El licenciamiento de las herramientas de software que emplea el 
laboratorio. 


= El licenciamiento de los modelos disponibles en el laboratorio. 
= Las políticas de acceso a las facilidades del laboratorio. 


Las tres primeras perspectivas son importantes a efectos de replicar el la- 
boratorio. Curiosamente, son muy pocos los desarrollos de laboratorios vir- 
tuales que se comparten con licenciamiento libre. La cuarta perspectiva incide 
en quiénes son los usuarios potenciales del laboratorio, así como en las posibi- 
lidades que hay de enlazarlo desde otras páginas (desde un LMS, por ejemplo). 


5.2 CLASIFICACIÓN Y EJEMPLOS 


En la literatura técnica se han reportado numerosos laboratorios virtuales con 
combinaciones diversas con respecto a las características enumeradas en la 
sección 5.1 (véanse, por ejemplo, [AN11, SYLLO2, RFT*09, MUDO8, GRO9, 
CLL12, DS10, MUDO6, PMM12, SOHA12, SZaZ11]). Con el propósito de pre- 
sentar un panorama general, a continuación se propone una clasificación de 
una amplia variedad de herramientas de software y hardware que permiten 
realizar experimentos. 


a. Programas de simulación de dominio específico: herramientas de software 
autónomo que han sido desarrolladas para simulación de sistemas de una 
única disciplina. Ejemplos muy conocidos son OrCad-PSpice ([Cad16] en 
el dominio de circuitos eléctricos), SolidWorks ([Sol16] en el dominio de 
modelado mecánico) y AspenHysys ([Asp16] en el dominio de procesos 
químicos). 


En estos programas de simulación generalmente el usuario debe construir 
el modelo mediante la conexión de componentes disponibles en una li- 
brería. El usuario también debe ajustar los parámetros de dichos modelos. 


201 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


202 


El software se encarga de generar las ecuaciones correspondientes (a par- 
tir de las leyes físicas que gobiernan el dominio específico), simularlas y 
presentar los resultados. 


El conjunto de leyes físicas que cada uno de estos simuladores maneja se 
limita al dominio específico, y el usuario no tiene la posibilidad de ampliar 
dicho conjunto. Por esta razón, los fenómenos que se pueden simular están 
circunscritos al dominio. A manera de ejemplo, usando un simulador de 
circuitos eléctricos, el usuario podrá incorporar en su modelo una bombi- 
lla eléctrica, y analizar sus variables eléctricas en un determinado circuito, 
pero probablemente no pueda simular la radiación de luz generada por la 
bombilla. 


Programas de cálculo de propósito general: programas de cálculo autó- 
nomos que incluyen rutinas de solución numérica de ecuaciones dife- 
renciales y de diferencia. Algunos de los más conocidos ejemplos son 
Matlab ([Mat16])), Scilab ([Ent16]), Gnu Octave ([pG16]) y Mathematica 
([Wol16]). 


Estos programas brindan ambientes de programación que permiten 
desarrollar aplicaciones de cálculo sofisticadas. Aprovechando esta posibi- 
lidad, se han desarrollado librerías con modelos de dominios específicos. 
En comparación con los simuladores de dominio específico, estas librerías 
suelen ser menos completas. Sin embargo, el potencial de cálculo y la 
libertad de programación hacen que esta alternativa sea muy versátil. 


Para desarrollar simulaciones multidominio, el usuario puede utilizar las 
rutinas de cálculo de las librerías de dominios específicos, pero es él 
quien debe formular las relaciones matemáticas que vinculan los distin- 
tos dominios. Esta tarea puede ser complicada porque las librerías no 
necesariamente son compatibles entre sí, en términos de precisión de 
cálculo, tiempos de respuesta de los modelos y estructura de datos (véase 
[FDS*12]). 


Programas de simulación multidominio: programas autónomos que per- 
miten la simulación de modelos multidominio a partir de la interconexión 
de elementos simples disponibles en librerías. El programa construye las 
relaciones matemáticas al interior de cada dominio y entre los diferentes 
dominios. En [FDS* 12] se listan dieciséis de estos programas y se destacan 
sus principales características. 
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d. Demostraciones en línea: aplicaciones orientadas a la web que muestran 
experimentos no interactivos; es decir, el usuario no puede modificar las 
condiciones del experimento. Pueden ser animaciones, videos o pequeñas 
aplicaciones de propósito específico. Por ejemplo, en [oCaLA10] se en- 
cuentra una colección de videos sobre experimentos del Department of 
Life Sciences Core Education Laboratories de la Universidad de Califor- 
nia en Los Ángeles. Estos videos tiene por propósito familiarizar a los es- 
tudiantes con los experimentos que luego desarrollarán en el laboratorio 
físico, haciendo énfasis en las exigencias de seguridad. 


e. Laboratorios interactivos en la web: laboratorios virtuales por antonoma- 
sia. Se trata de aplicaciones web en las que se simulan fenómenos a través 
de modelos matemáticos implementados en software. Usualmente los ex- 
perimentos están predefinidos: el usuario no tiene la posibilidad de crear 
sus propios experimentos ni de modificar la estructura de los ya existen- 
tes. La interacción del usuario se limita a la modificación de parámetros 
del experimento. 


f. Laboratorios remotos: aplicaciones en la web que permiten manipular dis- 
positivos físicos presentes en un laboratorio físico. Estos laboratorios se 
implementan generalmente con uno de dos propósitos: ampliar el hora- 
rio de servicio de algún laboratorio físico o brindar acceso al laboratorio a 
estudiantes en modelos de educación a distancia. 


A la anterior clasificación es necesario adicionarle numerosas combina- 
ciones de herramientas tales, como: 


= El uso de programas de simulación autónomos como motor de cálculo 
de laboratorios interactivos en línea (véanse [MUDOS8, SZaZ11]). 


= La interfaz entre programas de simulación de dominio específico o mul- 
tidominio con programas de cálculo de propósito general (véanse 
[NENO5, Mod16, Mod16)). 


5.3 LABORATORIOS Y APRENDIZAJE DE LA INGENIERÍA 


Para explorar el papel que cumplen los laboratorios en los procesos de apren- 
dizaje de la ingeniería, en esta sección se abordan tres perspectivas diferentes 
y complementarias: 


= La importancia de la experimentación por sí misma, como uno de los 
conocimientos propios de la ingeniería. 
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= La importancia del modelado y de la simulación por sí mismos, como 
herramientas básicas del ejercicio de la ingeniería. 


= La importancia de la experimentación como estrategia de aprendizaje de 
algunos temas fundamentales en la ingeniería. 


5.3.1 Importancia de la experimentación 


La importancia de la experimentación en el aprendizaje de la ingeniería difí- 
cilmente puede ser sobreestimada. La iniciativa CDIO (véase [BBC*+03]) ha 
identificado un conjunto amplio de habilidades generales que un ingeniero 
recién graduado debería tener. Este listado se ha construido bajo un concep- 
to según el cual los ingenieros deben estar en capacidad de concebir, diseñar, 
implementar y operar sistemas complejos (véase [Cra01]). Si bien este listado 
no es taxativo (debe adecuarse y priorizarse según el contexto), sí es una bue- 
na referencia para señalar los principales requerimientos del aprendizaje de la 
ingeniería. 
El listado de habilidades CDIO se organiza en cuatro tópicos: 


1. Conocimiento técnico y razonamiento. 
2. Aptitudes personales y profesionales y sus atributos. 
3. Habilidades interpersonales: trabajo en equipo y comunicación. 


4. Concebir, diseñar, implementar y operar sistemas en un contexto em- 
presarial y social. 


El tópico número 1 es específico para cada programa de ingeniería, mien- 
tras que los demás se consideran comunes a todos los programas de ingeniería. 
El número de habilidades listadas en los tópicos 2, 3 y 4 es cercano a 350. La 
tabla 5.1 muestra los subtópicos relacionados directamente con la experimen- 
tación, todos ellos incluidos en el tópico 2. 

Este listado de habilidades destaca la importancia de la experimentación 
por sí misma. En otras palabras, el ingeniero debe saber experimentar. Para 
desarrollar estas habilidades, es preciso que las actividades de experimenta- 
ción que realice un estudiante incluyen las siguientes tareas: 


= Documentación y análisis de la información previa. 
= Formulación de hipótesis. 


= Diseño de experimentos. 
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= Ejecución de experimentos. 


= Análisis de resultados. 


Tabla 5.1 Subtópicos CDIO relacionados directamente con habilidades de experimentación 


2.2. Experimentación y descubrimiento de conocimientos. 


2.2.1. Formulación de hipótesis. 


2.2.1.1. Preguntas clave que deben examinarse. 
2.2.1.2. Hipótesis que serán probadas. 
2.2.1.3. Controles y grupos de control. 


2.2.2. Búsqueda de literatura impresa y electrónica. 


2.2.2.1. Estrategia de búsqueda de literatura. 


2.2.2.2. Búsqueda de información e identificación usando herramientas como (catá- 
logos en línea, bases de datos y motores de búsqueda). 


2.2.2.3. Ordenamiento y clasificación de la información primaria. 
2.2.2.4. Calidad y confiabilidad de la información. 

2.2.2.5. Lo esencial y la innovación contenida en la información. 
2.2.2.6. Preguntas de investigación que están sin respuesta. 


2.2.2.7. Citas a referencia. 
2.2.3. Investigación experimental. 


2.2.3.1. El concepto y la estrategia del experimento. 

2.2.3.2. Las precauciones cuando los seres humanos son usados en experimentos. 
2.2.3.3. Construcción de experimentos. 

2.2.3.4. Protocolos de prueba y procedimientos experimentales. 

2.2.3.5. Medidas experimentales. 

2.2.3.6. Datos experimentales. 

2.2.3.7. Datos experimentales vs. modelos disponibles. 


2.2.4. Pruebas de hipótesis y defensa. 
2.2.4.1. Validez estadística de datos. 


2.2.4.2. Las limitaciones de los datos empleados. 
2.2.4.3. Conclusiones respaldadas en los datos, necesidades y valores. 


2.2.4.4. Posibles mejoras en el proceso de descubrimiento del conocimiento. 


5.3.2 Importancia del modelado y de la simulación 


La tabla 5.2 muestra el listado de habilidades CDIO relacionadas con el mo- 
delado y la simulación. Estas dos actividades se circunscriben en dos tópicos 
diferentes: 1) el razonamiento y la resolución de problemas, y 2) el diseño. Se 
colige, entonces, que un ingeniero debe saber construir modelos y simularlos 
para poder resolver problemas y diseñar esas soluciones. 
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Tabla 5.2 Listado de habilidades CDIO relacionadas con el modelado y la simulación 


2.1. Razonamiento y resolución de problemas de Ingeniería. 


2.1.1. Modelado. 
2.1.1.1. Suposiciones para simplificar sistemas complejos y las circunstancias que los 
rodean. 
2.1.1.2. Modelos conceptuales y cualitativos. 
2.1.1.3. Modelos cuantitativos y simulaciones. 


2.1.2. Estimación y análisis cualitativo. 


2.1.2.1. Órdenes de magnitud, fronteras y tendencias. 
2.1.2.2. Pruebas de coherencia y errores (límites, unidades, etc.). 
2.1.2.3. Generalización de soluciones analíticas. 


2.1.3. Análisis de incertidumbre. 


2.1.3.1. Información incompleta y ambigua. 

2.1.3.2. Modelos probabilísticos y estadísticos de eventos y secuencias. 
2.1.3.3. Análisis de riesgos y costo-beneficio. 

2.1.3.4. Análisis de decisiones. 


2.1.3.5. Márgenes y reservas. 
2.1.4. Soluciones y recomendaciones. 


2.1.1.1. Solución de problemas. 

2.1.1.2. Resultados esenciales de las soluciones y los datos de los ensayos. 
2.1.1.3. Discrepancias en los resultados. 

2.1.1.4. Resumen de las recomendaciones. 


2.1.1.5. Posibles mejoras en el proceso de solución de problemas. 
4.4. Diseñar. 


4.4.4. Diseño en la disciplina. 
4.4.4.1. Técnicas apropiadas, herramientas y procesos. 
4.4.4.2. Herramienta de diseño, calibración y validación. 
4.4.4.3. Análisis cuantitativo de alternativas. 
4.4.4.4. Modelado, simulación y pruebas. 
4.4.4.5. Perfeccionamiento analítico del diseño. 


4.4.5. Diseño multidisciplinario. 


4.4.5.1. Interacciones entre las disciplinas. 

4.4.5.2. Distintos convenios e hipótesis. 

4.4.5.3. Diferencias en la madurez de modelos disciplinarios. 
4.4.5.4. Ambientes multidisciplinario para el diseño. 


4.4.5.5. Diseño multidisciplinario. 
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El modelo, como abstracción de la realidad, y la simulación, como predic- 
ción del comportamiento de esa realidad, son dos herramientas fundamen- 
tales de la ingeniería. En ocasiones, basta con saber emplear los modelos y 
herramientas de simulación disponibles. No obstante, en muchas aplicaciones 
de ingeniería es necesario construir nuevos modelos o adaptar las herramien- 
tas de simulación. Por esta razón, es importante que el ingeniero se aproxime a 
los simuladores no como un mero usuario, sino con un conocimiento profun- 
do de los modelos matemáticos subyacentes y la forma en que esos modelos 
son tratados por los simuladores. 

En este sentido, es interesante destacar uno de los hallazgos reportados en 
[GKC*+09]. Se trata del reporte final producido por un panel de expertos del 
World Technology Evaluation Center (véase [Cen08]) en el que se evalúan de 
forma prospectiva las principales tendencias en investigación y desarrollo de 
simulaciones para las ciencias y la ingeniería. El hallazgo número 3 identifica 
la necesidad de una “nueva y moderna aproximación a la enseñanza y el 
entrenamiento de la próxima generación de investigadores en computación 
de alto desempeño específicamente, y en modelado y simulación en general, 
para el descubrimiento científico y la innovación en ingeniería”. 

Las herramientas de simulación están teniendo una evolución importan- 
te. La integración de herramientas computacionales es una nueva tendencia 
cuyo propósito es lograr un uso coherente de diversas herramientas de soft- 
ware especializadas en diseño, optimización, manufactura, etc. Implícita está 
la integración de herramientas de simulación entre sí, y con herramientas 
de diseño, optimización, documentación, etc. La formación de ingenieros 
y científicos que puedan desenvolverse en este escenario de integración, es 
identificada en [ColCME08] como un asunto de seguridad y competividad 
nacionales. 


5.3.3 La experimentación como estrategia de aprendizaje 


Son varios los estudios que reportan cómo la experimentación (real, virtual o 
remota) puede ayudar significativamente a la comprensión y el aprendizaje de 
ciertos temas. Algunos ejemplos de estos estudios son los siguientes: 


= En [FEl0] se realiza un estudio comparativo para evaluar el impacto del 
uso de laboratorios (físicos y virtuales) en el aprendizaje de circuitos 
eléctricos DC. El estudio evidencia un impacto considerable tanto en 
el aprendizaje del tema como en el desarrollo de habilidades de trabajo 
virtual. 
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= En [SOHA12] se realiza un estudio comparativo entre tres tecnologías de 


laboratorio: real, virtual y de realidad aumentada. El laboratorio virtual 
se implementa en Matlab y Simulink. Por su parte, el enfoque de realidad 
aumentada consiste en la incorporación de videos e imágenes. Ahora, el 
estudio se basa en una encuesta a estudiantes que desarrollan prácticas 
en los tres tipos de laboratorio. El tema sobre el que se desarrollan las 
prácticas son conceptos básicos de circuitos eléctricos. Las encuestas 
revelan que el enfoque de realidad aumentada tiene como fortaleza la 
facilidad de uso y una mejor comprensión de los conceptos. 


En [SDGL10] se reporta una mejoría en varios aspectos del proceso de 
aprendizaje sobre perforación de pozos mediante el uso de una labora- 
torio virtual: 


+ Mayor motivación hacia los estudiantes. 
+ Mejora en las habilidades de aprendizaje autónomo. 
+ Mayor eficiencia en la enseñanza. 


» Mejor soporte al aprendizaje continuo a distancia. 


En [KERS*12] se presentan las experiencias de docentes y estudiantes 
en el uso de herramientas de simulación en la enseñanza de ingeniería 
química. Se emplean herramientas comerciales como DSpice y KSpice. 
Los temas abordados son: 


+ Ingeniería química básica, un curso de pregrado en el Oslo Univer- 
sity College. 

+ Análisis de operabilidad y seguridad, un curso de posgrado en la 
Technical University of Denmark. 


+ Control de procesos, un curso de pregrado y posgrado en la Aston 
University. 


El artículo hace énfasis en la manera como se han integrado las activi- 
dades de simulación en cada uno de los cursos. El diseño de cada ex- 
perimento está relacionado con los objetivos de cada curso y el nivel de 
conocimiento de los estudiantes. 


En [RFT*09] se presenta un extenso portal para la enseñanza de inge- 
niería química. La validación del portal se realiza mediante una encuesta 
a los estudiantes, quienes en su mayoría lo consideran útil o muy útil, y 
bien estructurado. La arquitectura empleada utiliza CGÍ para comunicar 
la interfaz web con el motor de cálculo, que emplea Matlab. 


LABORATORIOS VIRTUALES. ESTADO DEL ARTE 


= En [MoL06] se enumeran algunos argumentos a favor del uso de juegos 
y simulaciones en la educación de adultos: 
+ Ambientes libres de riesgo. 
+ Experimentación. 
+ Habilidades para la solución de problemas. 
+ Evaluación. 


. Interacción social. 


Cultura de jugadores. 


= En [MoL06] se identifican cuatro aspectos que se deben abordar para 

aprovechar el potencial pedagógico de las simulaciones y los juegos: 

+ El diseño instruccional. 

+ La facilitación. 

+ La evaluación. 

+ Los estándares de e-learning. 
En el mismo documento, se clasifica la literatura revisada sobre unos 
aspectos pedagógicos relacionados con las simulaciones: 

+ Sistemas de creencias de los docentes: ocurrencia en 17 %. 

+ Sistemas de creencias de los estudiantes: ocurrencia en 49 %. 

» Obtención de competencias profesionales: ocurrencia en 15%. 

+ Requerimientos de habilidades en el uso de nuevas tecnologías: ocu- 


rrencia en 7%. 


= En [AN11] se muestra una estrategia para incorporar tres tipos de ex- 
perimentación en educación: directa, virtual y remota. Los tres tipos de 
acceso se utilizan en un mismo curso, con el propósito de explotar las 
principales ventajas de cada uno de ellos. Como resultado, se eviden- 
cian los beneficios de utilizar un laboratorio virtual antes de acceder al 
laboratorio directo. 


= En [MNI11] se hace una revisión de cincuenta y tres experiencias re- 
portadas en diez años. En dicho trabajo se destaca la importancia de la 
presencia y la inmersión, como variables que requieren mayor investi- 
gación. Estos conceptos, no obstante, son bastante amplios; la presencia, 
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por ejemplo, se considera como una experiencia subjetiva, de tal forma 
que es coherente hablar de presencia a distancia, a través de medios de 
comunicación. 


No es de extrañar, entonces, que los planes de estudio de las distintas in- 
genierías incluyan actividades de experimentación en los temas considerados 
como críticos o fundamentales para cada una de ellas. Se suelen seleccionar 
de forma estratégica los temas sobre los cuales se debe realizar una experi- 
mentación, para optimizar el uso de los recursos físicos disponibles en los 
laboratorios. 


5.4 CONSIDERACIONES EN EL DISEÑO DE LABORATORIOS VIRTUALES 


Varias de las experiencias reportadas en la literatura sobre el uso de ambientes 
virtuales de aprendizaje se acompañan de evaluaciones sobre su efectividad. 
Son menos las que exploran la incidencia de las características de diseño del 
sistema que impactan en su éxito. En [MS11] se hace una revisión detallada de 
treinta de esas evaluaciones, la mayoría de las cuales están basadas en encues- 
tas realizadas a los usuarios. Para ello, clasifica las características de diseño 
en las que están relacionadas con el sistema y en aquellas relacionadas con la 
información (véase tabla 5.3). 


Tabla 5.3 Características de diseño de un ambiente virtual de aprendizaje reportadas en [MS11] 


Relacionadas con el sistema Relacionadas con la información 


Accesibilidad, comunicatividad, interactividad, | Características del curso, calidad del curso, for- 
diseño de la interfaz, comunidad de aprendiza- | mato, tipo de material, relevancia, terminología. 
je, navegación, personalización, disponibilidad, 
adaptabilidad, flexibilidad, funcionalidad, tiem- 
po de respuesta, usabilidad, adaptación al usua- 
rio, herramientas para el usuario. 


Por su parte, en [CLL12] se propone el uso del proceso analítico jerárquico 
difuso para identificar los requerimientos no funcionales de un laboratorio 
virtual. El asunto se aborda como un problema de decisión multicriterio para 
establecer la priorización de los criterios cualitativos que se involucran en el 
diseño del laboratorio como un servicio web. Estos criterios son tomados del 
estándar ISO/TEC 9126. Tras efectuar un análisis con 20 actores, se obtiene un 
listado ordenado de criterios (el primero es el prioritario): 


= Funcionalidad 


= Confiabilidad 
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Usabilidad 


Eficiencia 


Mantenibilidad 


Portabilidad 
= Seguridad 


Por otra parte, no hay que olvidar que un laboratorio virtual no es más 
que una herramienta. En este sentido, su éxito depende del uso que de ella se 
haga. Esto es particularmente importante en su aplicación en la docencia, en 
donde el uso depende de la estrategia pedagógica seleccionada. 

Los experimentos disponibles a través de laboratorios virtuales enfoca- 
dos a la docencia pueden considerarse como Objetos Virtuales de Aprendizaje 
(OVA) ([Dua09]). Como tales, es deseable que sean reutilizables en diferentes 
contextos de aprendizaje. Este aspecto no suele ser explorado en los estudios 
de éxito de ambientes virtuales de aprendizaje, ya que estos se realizan en con- 
textos limitados, tales como una cohorte de un único curso. 

En [Dav08] se hace un compendio de un conjunto muy útil de recomen- 
daciones y guías para el diseño de laboratorios y actividades de laboratorio 
para planes de estudio de ingeniería. El documento se estructura alrededor 
de cinco ejes de diseño de un curso: 1) propósitos y objetivos de aprendizaje, 
2) diseño de aprendizaje, 3) entregas, 4) valoración, y 5) evaluación. A con- 
tinuación se resumen algunas de las recomendaciones para los dos primeros 
aspectos: 


a. Propósitos y objetivos de aprendizaje: el documento recoge las recomen- 
daciones de [GGM97] según las cuales es preferible concentrarse en los 
objetivos de alto nivel: 


= Desarrollo de habilidades experimentales, de diseño, de análisis y so- 
lución de problemas. 

= Desarrollo de habilidades de análisis y registro de datos. 

= Familiarizar a los estudiantes con equipo, técnicas y materiales. 

= Desarrollo de habilidades prácticas. 

= Desarrollo de habilidades interpersonales y de comunicación. 

= Desarrollo de juicios técnicos y práctica profesional. 


= Integración de teoría y práctica. 
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= Motivación a los estudiantes. 


Diseño de aprendizaje: el diseño de las actividades específicas a desarrollar 
está influenciado por el modelo de aprendizaje subyacente. El modelo de 
Aprendizaje por Experiencia (Experiential Learning) propuesto en [Kol84] 
es particularmente útil para entender el papel que los laboratorios deben 
cumplir en el proceso de aprendizaje. 


De este modelo, destacamos los siguientes aspectos: 


= De acuerdo con el modelo, el aprendizaje es un proceso iterativo (o 
una espiral) como el representado en la figura 5.2. 


Experiencia 
concreta 


Hacer/ 
experimentar 


Observación 
reflexiva 


Experimentación 
activa 


Planear /probar 


Revisar /reflexionar 
lo aprendido 


sobre la experiencia 


Conceptualización 
abstracta 


Conclusiones /aprendizaje] 
de la experiencia 


Figura 5.2 Modelo del aprendizaje de Kolb (Tomado de [Dav08]) 


= Cada estudiante tiene preferencias propias sobre cómo utilizar dife- 
rentes fases del ciclo, lo que establece diferentes estilos de aprendizaje. 
Los estilos de aprendizaje están influenciados por varios factores in- 
ternos y externos, y evolucionan a lo largo de la vida de cada individuo 
(véanse [Kol81], [KK05], [JKO9], [BK91]). 


De acuerdo con este enfoque, es importante proveer a los estudiantes di- 
ferentes entradas factibles al ciclo de aprendizaje. Igualmente importante 
es distinguir el nivel de autonomía requerido para cada tipo de actividad 
de laboratorio, tal como se muestra en la tabla 5.4. Un diseño curricular 
coherente debería contemplar un nivel progresivo de autonomía a lo largo 
del plan de estudios?. 


2En [ANO9] se puede ver una aplicación de los principios del aprendizaje por experiencia a un curso 


control de procesos en Ingeniería Química que combina laboratorios remotos, virtuales y físicos. 
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Tabla 5.4 Niveles de autonomía y tipos de actividad de laboratorio (tomado de [Dav08]) 


Nivel de | Tipo de Condiciones 
autonomía | actividad Objetivos | Material Método Respuesta 

0 Demostración| Dado Dado Dado Dado 

1 Ejercicio Dado Dado Dado Abierto 

2 Investigación | Dado Dado o Abierto o Abierto 
estructurada parcialmente parcialmente 

dado abierto 

3 Investigación | Dado Abierto Abierto Abierto 
abierta 

4 Proyecto Abierto Abierto Abierto Abierto 
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En este capítulo se presenta en detalle la estructura interna de UNVirtualLab. 
El capítulo inicia con la presentación de las especificaciones de la herramien- 
ta (sección 6.1); a continuación se presenta el modelo Entidad-Relación de la 
base de datos subyacente (sección 6.2), así como los componentes de la im- 
plementación (sección 6.3), la interfaz gráfica (sección 6.4), la estrategia de 
implementación (sección 6.5) y las opciones de configuración (sección 6.6). 
En los apéndices B, C y D se ha incluido información complementaria. 


6.1 ESPECIFICACIONES 
6.1.1 Características 


UN VirtualLab ha sido concebido como un ambiente de simulación de siste- 
mas dinámicos enfocado al aprendizaje. Dicho ambiente es una herramienta 
de propósito general, en el sentido de que puede alojar plantas de experimen- 
tación de diferentes disciplinas y niveles de formación. Las plantas alojadas en 
UN VirtualLab se desarrollan bajo modelos que facilitan la representación de 
fenómenos en múltiples dominios. 

A continuación se presentan las características de UNVirtualLab siguien- 
do la enumeración dada en la sección 5.1: 


a. Orientación a la web: UNVirtualLab es una herramienta web cuyos mo- 
delos pueden usarse en herramientas stand-alone. De esta forma, mientras 
la orientación hacia la web permite el acceso remoto a las plantas de expe- 
rimentación disponibles, el uso de las herramientas stand-alone facilita el 
desarrollo de experimentos más complejos por parte del usuario. 


b. Naturaleza de los modelos: UN VirtualLab es una herramienta de simula- 
ción. Los experimentos son ejecuciones de programas construidos sobre 
modelos matemáticos. Se ha decidido que sea así y no un laboratorio 
remoto, para que sea muy versátil y de esa forma pueda alojar experimen- 
tos de múltiples disciplinas y niveles de formación. 


c. Dominio de los experimentos: UNVirtualLab puede alojar plantas de ex- 
perimentación multidominio. Los modelos que subyacen a los experimen- 
tos se desarrollan en un lenguaje que facilita la representación multidomi- 
nio. Este aspecto permite desarrollar experimentos cuya complejidad lleva 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


al usuario a enfrentarse con la necesidad de abordar de forma interdisci- 
plinaria los fenómenos modelados. 


d. Interactividad: UNVirtualLab permite que el usuario tenga una interacti- 
vidad discontinua con el experimento. La interactividad es indispensable 
para que el usuario modifique los parámetros de los experimentos y así 
amplie su experiencia de aprendizaje. Cabe anotarse que la interactividad 
continua no se ha incorporado por no considerarse un aspecto crítico en 
la experiencia de aprendizaje. 


e. Apoyo al aprendizaje: UNVirtualLab tiene un enfoque hacia el aprendi- 
zaje. Puede considerarse como una herramienta de apoyo a la docencia, 
aunque también puede utilizarse en modelos de autoaprendizaje. El apren- 
dizaje por experiencia es el modelo subyacente ([Kol84]). UNVirtualLab 
provee diferentes elementos para facilitar que el estudiante acceda al ciclo 
de aprendizaje en diferentes puntos, de acuerdo con su estilo de aprendiza- 
je ([KKO05]). La figura 6.1 muestra los diferentes puntos de entrada al ciclo, 
así como los elementos que lo facilitan. Desde otra perspectiva, es posi- 
ble emplear UNVirtualLab para desarrollar actividades de aprendizaje de 
todos los tipos propuestos en [Dav08] y recogidos en la tabla 5.4. 


f. Disponibilidad de los modelos: UN VirtualLab permite que el usuario ten- 
ga acceso a una amplia documentación de los modelos. También permite 
que el usuario descargue el código fuente de los modelos y de los experi- 
mentos, para que los adapte y corra en herramientas stand-alone. 


g. Integración con LMS y compatibilidad SCORM: los experimentos dispo- 
nibles en UNVirtualLab pueden enlazarse directamente desde ambientes 
LMS, o ser empaquetados como enlaces en archivos SCORM. 


h. Licenciamiento y acceso: UN VirtualLab se distribuye bajo licenciamien- 
to libre (véase apéndice A). Los experimentos y modelos se distribuyen 
también bajo esa misma licencia, y son compilables en herramientas de 
software libre. El acceso alos experimentos es abierto al público en general. 


6.1.2 Concepto de diseño 


UNVirtualLab combina 1) el potencial de modelamiento del lenguaje 
Modelica, 2) la capacidad de simulación de OpenModelica, y 3) la facilidad 
de acceso que brinda la web. 
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Experiencia 
concreta 
Hacer/ 
Experimentar 
Observación 


Plantas de 
experimentación. 
Experimentación 
activa reflexiva 
Planear/probar Revisar /reflexionar 
Experimentar sobre la experiencia 


Plantas modificables. Resultados 
Código del modelo. experimentales. 


Conceptualización 
abstracta 


Conclusiones / aprendizaje 
de la experiencia 


Documentación. 
Marco teórico. 


Figura 6.1 UNVirtualLab como herramienta de aprendizaje bajo el modelo de Kolb [Dav08]. En 
sombreado los elementos presentes en UNVirtualLab que brindan acceso al ciclo de aprendizaje 


Para explicar cómo se logra esta combinación, conviene recordar cómo 
interactúa OpenModelica con los archivos para producir una simulación (véa- 
se la figura 4.4): OpenModelica toma un archivo de texto escrito en lenguaje 
Modelica y produce varios archivos de los cuales destacamos tres: 


= Un archivo ejecutable. 
= Un archivo de texto con parámetros de entrada para el ejecutable. 


= Un archivo con los resultados de la simulación, que es generado por el 
ejecutable cuando este se corre. 


Este esquema permite aprovechar el mismo ejecutable para correr simu- 
laciones en condiciones diferentes. Para ello es necesario modificar el archivo 
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con los parámetros de entrada. No obstante, ninguna de las herramientas dis- 
ponibles en la suite OpenModelica están diseñadas para editar el archivo de 
entrada; todas ellas han sido concebidas para interactuar con el modelo en 
sí mismo. 

UN VirtualLab brinda una interfaz web para modificar los archivos de en- 
trada de simulaciones compiladas previamente con OpenModelica. La figura 
6.2 ilustra el proceso: el usuario interactúa con la interfaz web para ajustar los 
parámetros del experimento y para ver los resultados de este; cuando se lanza 
una simulación a través de la interfaz, UNVirtualLab crea un archivo de en- 
trada temporal con los ajustes del usuario, corre la simulación con ese archivo 
y lee los resultados para desplegarlos en diferentes formatos!. 


Usuario Animaciones 


—— 


Ajuste de Gráficas B 
parámetros 


Leer Lanzar Mostrar 
valores ejecutable resultados 


Archivo de Archivo de 


Archi 
entrada : ea resultados 
ejecutable 


temporal temporal 


Figura 6.2 Archivos en una simulación de UNVirtualLab 


¡En [TTHFR11] se muestra otro enfoque diferente para dotar a OpenModelica de la facilidad de ac- 
ceso que brinda la web: la interfaz permite modificar los archivos Modelica, de tal manera que al lanzar 
una simulación el sistema debe cada vez compilar el modelo para generar un nuevo ejecutable antes de 
correr la simulación. Para los autores de [TTHFR11], el propósito del ambiente de simulación es princi- 
palmente el aprendizaje del lenguaje Modelica, por lo que la edición en línea de los archivos del modelo 
es fundamental. No obstante, al introducir esta funcionalidad, los tiempos de simulación se incrementan 
considerablemente. 
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La información asociada a UNVirtualLab se aloja en una base de datos 
relacional. El diagrama UML de actividades de la figura 6.3 muestra con más 
detalle el proceso de simulación en UNVirtualLab enumerado a continuación: 


desplegar ) 


Leer planta de 


experimentación en 


a a mostrar 
mostrar info de Leer archivo 
resultados por 


la planta init por defecto 
defecto 


aj =p o 


mostrar WN 
parámetros por 
generar 
generar figuras E 
animaciones 
y 2 
modificar 
parámetros Nr 
a) a) 


Leer crear archivo Leer archivo crear archivo 
E ¿de simular 
parámetros init init res 


Figura 6.3 Diagrama UML de actividades de una simulación en UNVirtualLab 


generar tablas ) 


A 


UNVL.1. Al seleccionar una planta de experimentación, el sistema busca la 
información correspondiente en la base de datos y despliega tres 
tipos de contenidos: 

= La documentación de la planta 
= El valor por defecto de los parámetros editables 
= Los resultados de la simulación con los valores por defecto 


UNVL.2. El usuario puede en este punto modificar el valor de los parámetros 
antes de lanzar la simulación. 


UNVL.3. Una vez se lanza la simulación, el sistema lee los valores actuales de 
los parámetros y construye un archivo init que será leído por el 
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ejecutable. El sistema corre el ejecutable que genera el archivo res 
que contiene los resultados de la simulación. 


UNVL.4. El sistema despliega los resultados en formato de gráficas, tablas 


y animaciones, siguiendo la información consignada en la base 
de datos. 


6.1.3 Especificaciones funcionales 


Para enumerar los requerimientos funcionales (RF), se consideran dos tipos 
de usuario: el experimentador y el administrador (véase sección 6.1.4). Las 
funciones que UNVirtualLab debe realizar son las siguientes: 


RE1. 


RE2. 


RE3. 


RE4. 


RE5. 


RE6. 


RE7. 
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Mostrar al experimentador la colección de plantas de experimentación 
disponibles. 


Permitir que el experimentador seleccione la planta de experimentación 
sobre la que desea trabajar. 


Mostrar al experimentador documentación útil para entender la planta 
y los modelos subyacentes. 


Mostrar al experimentador los valores por defecto de los parámetros de 
la planta. 


Permitir que el experimentador modifique los valores de los parámetros 
de la planta. 


Permitir que el experimentador recupere los valores por defecto de los 
parámetros de la planta. 


Ejecutar el experimento (es decir, simular el comportamiento de la plan- 
ta de experimentación) con los valores de los parámetros que seleccione 
el experimentador. Este requerimiento implica los siguientes subreque- 
rimientos: 


RF 7.1. Crear los archivos temporales de entrada para cada simulación 
lanzada por el experimentador. 


RE 7.2. Leer los archivos temporales generados por los ejecutables en 
cada simulación lanzada por el experimentador. 


RE 7.3. Presentar los resultados de los experimentos usando varios for- 
matos: gráficas, tablas y animaciones. 
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RE 7.4. Borrar los archivos temporales una vez sevpresenten los 
resultados. 


RE8. Permitir que el experimentador descargue los modelos subyacentes al 
experimento. 


RE9. Permitir que el experimentador descargue los valores numéricos de las 
variables simuladas en un experimento. 


RE10. Mostrar al experimentador la información sobre la autoría de los mo- 
delos y experimentos. 


RE. 11. Controlar el acceso del administrador mediante una contraseña. 


RE12. Permitir que el administrador seleccione el idioma en que se presentará 
la interfaz. 


RF.13. Permitir que el administrador modifique la apariencia de la interfaz a 
través de archivos CSS. 


RE 14. Mostrar al administrador la colección de plantas de experimentación 
disponibles. 


RE15. Permitir que el administrador adicione y elimine plantas de 
experimentación. 


RE16. Permitir que el administrador cree secciones de plantas de forma 
jerárquica. 


RE17. Permitir que el administrador ubique las plantas en la sección que desee. 


RE18. Permitir que el administrador habilite o inhabilite la presentación de 
cada planta de expermientación a los experimentadores. 


RE19. Permitir que el administrador edite la información asociada a 
cada planta. 


RE20. Permitir que el administrador adicione, edite y elimine experimentos 
sugeridos a los experimentadores para cada experimento. 


RE21. Permitir que el administrador habilite e inhabilite los experimentos 
sugeridos a los experimentadores para cada planta de experimentación. 


RE22. Permitir que el administrador seleccione los parámetros que serán mo- 
dificables por el experimentador, para cada planta de experimentación. 
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RE23. Permitir que el administrador adicione, edite y elimine grupos de con- 
troles en cada planta de experimentación; estos contendrán los paráme- 
tros editables por los experimentadores. 


RE24. Permitir que el administrador habilite e inhabilite grupos de controles 
en cada planta de experimentación. 


RE25. Permitir que el administrador adicione y elimine los parámetros edi- 
tables por los experimentadores en cada grupo de control y para cada 
planta de experimentación. 


RE26. Permitir que el administrador habilite e inhabilite parámetros en cada 
grupo de control. 


RE.27. Permitir que el administrador edite la información asociada a cada pa- 
rámetro editable por el experimentador, como: nombre, valor por de- 
fecto, valores mínimo y máximo permitidos, entre otros datos. 


RF.28. Permitir que el administrador adicione y elimine gráficas para desple- 
gar los resultados de cada planta de experimentación. 


RE29. Permitir que el administrador habilite e inhabilite gráficas en cada plan- 
ta de experimentación. 


RE30. Permitir que el administrador edite la información asociada a cada grá- 
fica de cada planta de experimentación, tal como: título, escalas hori- 
zontal y vertical, número de divisiones verticales y horizontales. 


RE31. Permitir que el administrador adicione y elimine curvas en cada gráfica 
para desplegar los resultados de cada experimento. 


RE32. Permitir que el administrador habilite e inhabilite curvas en cada 
gráfica. 


RE33. Permitir que el administrador edite información asociada a cada cur- 
va de cada gráfica de cada experimento, tal como: color de la curva y 
nombre de la variable graficada. 


RE34. Permitir que el administrador adicione y elimine animaciones en 2D 
para presentar los resultados de las simulaciones. 


RE35. Permitir que el administrador edite información asociada a cada ani- 
mación de cada experimento, tal como: título, duración de la animación 
y tiempo de actualización. 
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RE36. Permitir que el administrador asocie variables de simulación a las pro- 
piedades geométricas de la animación. 


RE37. Permitir que el administrador adicione, elimine y edite información 
sobre los autores de los modelos y experimentos. 


RE38. Permitir que el administrador asocie autores de modelos y experimen- 
tos a cada planta de experimentación. 


RE39. Permitir que el administrador cargue la documentación asociada a 
cada planta de experimentación para que esté a disposición de los 
experimentadores. 


RE40. Permitir que el administrador cargue el código fuente asociado a 
cada planta de experimentación para que esté a disposición de los 
experimentadores. 


RF41. Permitir que el administrador cargue el archivo ejecutable, junto con 
los archivos por defecto de entrada y salida de la simulación. 


RF.42. Crear los archivos de imágenes de gráficas y animaciones por 
defecto de cada experimento para que estén a disposición de los 
experimentadores. 


6.1.4 Casos de uso 


A partir de las especificaciones funcionales se han derivado los casos de uso 
que se muestran en las figuras 6.4, 6.5 y 6.6. Los tipos de usuario identi- 
ficados son?: 


a. Experimentador: que utiliza UN VirtualLab para realizar experimentos vir- 
tuales. La figura 6.4 muestra los casos de uso asociados a este usuario y que 
corresponden a los requerimientos funcionales 1 al 10. 


b. Administrador: que gestiona el sistema y la información relacionada con 
los experimentos virtuales. La figura 6.5 resume los casos de uso asociados 
al administrador que corresponden a los requerimientos funcionales 11 al 
42. Se destacan las funciones de inicio y cierre de sesión, y dos bloques 


2Existe un tercer tipo de usuario, el modelador, que es quien crea los modelos y experimentos. No 
obstante, este usuario no interactúa directamente con UN VirtualLab, sino que emplea OpenModelica para el 
desarrollo de los modelos y experimentos. Una vez estos modelos están listos, se incorporan a UNVirtualLab 
a través de las funciones del administrador. Por esta razón, no es necesario considerar al usuario modelador 
en la explicación de la arquitectura del sistema. 
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de casos: uno asociadolím a las secciones de las plantas, y otro asociado 
a las plantas de experimentación en sí. La figura 6.6 amplía los casos de 
uso asociados a la edición de cada planta de experimentación. 


ÓN información 
O 


Selecciona planta 
Experimentador 


Consulta documentación 


Restaura parámetros Simula Descarga datos 


Modifica parámetros 


Figura 6.4 Diagrama UML de casos de uso para el experimentador 


Selecciona sección Crea sección Edita sección Elimina sección 


DO. Q ES 
A 


Administrador 


Selecciona planta Crea planta Edita planta Elimina planta 


Inicia sesión Cierra sesión 


Figura 6.5 Diagrama UML de casos de uso para el administrador 
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6.2 MODELO ENTIDAD-RELACIÓN 


Para gestionar la información asociada a UNVirtualLab se ha diseñado una 
base de datos relacional sobre el motor mysql (véase [Cor22]). El diagrama 
Entidad-Relación de la base de datos se muestra en la figura 6.7, mientras que 
la estructura de cada una de las tablas se reseña en el apéndice B. 


modellers_models| |. [rro FK  control_group_id 


FK  parameter_id 


FK  modeller_id 
FK  model_id 


PAE 0O- a ii FK  model_id 
FK  model_id Tn 
FK- variable_id 


0 --"| FK  model_id 


FK  plot_id 


2danimation_id 
variable_id 
variable_aux_id 


[——] -Untlamed- 
[——] -Untlamed - 


Figura 6.7 Diagrama Entidad-Relación de la base de datos 


A continuación se explica el tipo de información que se aloja en cada una 
de las tablas: 


= sections: cada registro de esta tabla describe una sección de experi- 
mentos. Las secciones pueden anidarse para constituir una estructura 
de árbol. Esto se logra con el campo section_id, que funciona como 
apuntador al registro padre de la sección. 
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models: cada registro de esta tabla describe el modelo ejecutable de un 
experimento, es decir, a una planta de experimentación. El campo 
section_id apunta a la sección a la que pertenece la planta. 


modellers: cada registro de esta tabla contiene información sobre un au- 
tor o coautor de un modelo o experimento. 


modellers_models: esta tabla sirve para construir la relación co + oo 
entre los modelos (models) y sus autores (nodellers). 


practices: cada registro de esta tabla describe un experimento sugerido 
para ser realizado con una determinada planta de experimentación. El 
campo model_id apunta al modelo de la planta con el que se realiza el 
experimento. 


variables: cada registro de esta tabla contiene información de una de 
las variables que se simulan al ejecutar un modelo específico. El cam- 
po model_id apunta al modelo al que pertenece la variable. 


parameters: cada registro de esta tabla contiene información de uno de 
los parámetros disponibles para ser modificados en los archivos de en- 
trada de un modelo específico. El campo mode1_id apunta al modelo al 
que pertenece el parámetro. 


control_groups: los parámetros que el experimentador puede modificar 
se pueden agrupar en grupos de controles. Cada registro de esta tabla 
describe uno de tales grupos asociados a un modelo específico. El campo 
model_id apunta al modelo al que pertenece el grupo de controles. 


controls: cada registro en esta tabla describe un parámetro que puede 
ser controlado (modificado) por el experimentador. El campo control _ 
group_id identifica el grupo al que pertenece el control, mientras que 
el campo parameter_id identifica de qué parámetro se trata. 


plots: cada registro de esta tabla identifica una gráfica para presen- 
tar los resultados de la simulación de un determinado experimento. 
El campo model _id apunta al modelo cuyo resultado será graficado. El 
campo variable_id identifica la variable que estará en el eje horizontal 
(la abscisa). 


curves: en una misma gráfica se pueden dibujar varias curvas (con la 
misma abscisa). Cada registro de esta tabla describe una curva de una 
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gráfica determinada. El campo plot_id apunta a la gráfica correspon- 
diente, mientras que el campo variable_id indica cuál es la variable 
que será graficada (la ordenada). 


= 2danimations: cada registro de esta tabla contiene información sobre 
una animación que se emplea para mostrar los resultados de la simula- 
ción de un modelo determinado. El campo model_id apunta al modelo 
cuyo resultado será animado. 


= 2deftects: las animaciones son alteraciones de propiedades geométricas 
o gráficas de un archivo gráfico. Dichas alteraciones se han denomina- 
do efectos de animación. Cada registro de esta tabla contiene un efecto 
de una animación determinada. El campo 2danimation_id apunta a la 
animación a la que pertenece el efecto. El campo variable_id apun- 
ta a la variable que controla el efecto. Si el efecto requiere información 
de alguna variable auxiliar, el campo variable_aux_id se emplea para 
apuntar a ella. 


= users: cada campo de esta tabla se utiliza para guardar información de 
los usuarios que tiene acceso con el rol de administrador. 


6.3 COMPONENTES 


UN VirtualLab es una aplicación web que emplea varios componentes para su 
operación. El conjunto de componentes requeridos no es el mismo para todos 
los usuarios y configuraciones. Pueden distinguirse los siguientes casos: 


a. Experimentador: utiliza los experimentos disponibles en alguna imple- 
mentación de UNVirtualLab en la web; es decir, es fundamentalmente un 
cliente de UNVirtualLab. La figura 6.8 muestra los componentes requeri- 
dos, la cual básicamente consta de un navegador web con un intérprete de 
archivos SVG. 


b. Experimentador avanzado: además de utilizar como cliente los experimen- 
tos de alguna implementación web de UNVirtualLab, descarga los modelos 
para editarlos y compilarlos localmente. Como muestra la figura 6.9, este 
usuario requiere, además del navegardor, una instalación local de Open- 
Modelica. 


c. Servidor mínimo: una implementación mínima del servidor de UNVir- 
tualLab requiere los módulos que se muestran en la figura 6.10. Se trata 
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de una aplicación web típica basada en mysql y php en la que el conjun- 
to de scripts desarrollados se han agrupado en el módulo denominado 
UN VirtualLab. En esta implementación los archivos ejecutables de los 
modelos son compilados externamente y cargados al servidor. 


OpenModelica:OM 


( Modelica Standard Library:OM 


OmsShell:OM 


Web client 


E OmsShellTerminal:OM Í É Web browser:Web client Í 


OA AS | 
OmeEdit:OM / 
SVG interpreter:Web client 
OmNotebook:O0M 
á MDT eclipse plugin:OM Í 
OmPython:OM 


Figura 6.8 Diagrama UML de implementación. Módulos para el experimentador sin edición de modelos 


d. Servidor con compilación: en esta implementación el servidor se encar- 
ga de compilar los modelos desarrollados en lenguaje Modelica. Como se 
observa en la figura 6.11, además de los módulos de una implementación 
web típica, es necesario instalar un subconjunto de las aplicaciones de la 
suite OpenModelica. Esta implementación es necesaria cuando el sistema 
operativo del servidor es diferente del que existe en la plataforma externa 
donde se desarrollan los modelos. 


e. Servidor para el modelador: la implementación sugerida para el desarro- 
llador de modelos y experimentos consta de una instalación completa de la 
suite OpenModelica, acompañada de una instalación local del un servidor 
UN VirtualLab. El conjunto completo se muestra en la figura 6.12. 
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OpenModelica:OM 


Modelica Standard Library:OM 


OMC:OM 


OmShell:OM 


OmsShellTerminal:OM 


OmEdit:OM 


OmNotebook:O0M 


Ñ MDT eclipse plugin:OM 


) 


OmPython:OM 


Web client 


Ñ Web browser:Web client Ó 


SVG interpreter:Web client 


Figura 6.9 Diagrama UML de implementación. Módulos para el experimentador avanzado con edición 


de modelos 


La tabla 6.1 muestra las características de los módulos empleados en el 
desarrollo de la versión 2.0 de UNVirtualLab?. 


Tabla 6.1 Características de los módulos de la versión 2.0 de UNVirtualLab 


Módulo 


Nombre 


Versión 


Sistema operativo 


Linux ubuntu 


16.04 LTS sobre procesador AMD Ath- 
lon(tm) II P340 Dual-Core Processor x 2 de 
64 bits 


Servidor web apache 2.4.18 
Servidor mysql mysql-server 5.7.21 
Intérprete php php7 7.0.28 
Suite OpenModelica OpenModelica 1.13.0. 

. firefox 59.0.2 
Clientes web 

google-chrome-stable 51.0.2704 

Scripts UNVirtualLab UNVirtualLab 2.0 


3Para obtener información sobre la versión 1.0, véase el apéndice E. 


232 


UNVIRTUALLAB. ARQUITECTURA 


:BD 
mysql server:BD 
É unvi:DB ) 
pS 


apache:Web server 
( Ejecutables:UN Virtual Lab ) T 
( Administración:UN Virtual Lab ) 


php:Web server 


:UN Virtual Lab 
¡Web server 
Experimentación:UN Virtual Lab 


Figura 6.10 Diagrama UML de implementación. Módulos del servidor mínimo de UNVirtualLab 


:BD 


mysql server:BD 


unvi:BD 


PND 
SN UY 


--> 


OmsShell:OM 


OmsShellTerminal:OM 


Administración:UN Virtual Lab 


ENFNEN 
NENE 
NES NN NES] 


K--- 


¡Web server 


apache:Web server 


php:Web server 


Figura 6.11 Diagrama UML de implementación. Módulos del servidor de UNVirtualLab con 
compilación de modelos 


OpenModelica:OM :UN Virtual Lab 
Modelica Standard Library: OM O Experimentación:UN Virtual Lab 
OMC:OM O KE. Ejecutables:UN Virtual Lab 
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OpenModelica:OM 


Modelica Standard Library:OM 


OMC:OM 


OmShell:OM 


OmShellTerminal:O0M 


:UN Virtual Lab 


Experimentación:UN Virtual Lab 


Ejecutables:UN Virtual Lab 


mysql server:BD 


Administración:UN Virtual Lab 


unvi:BD 


SVG editor:UN Virtual Lab 


OmeEdit:OM 


OmNotebook:OM 


Mí 


Web server 


Web client 


apache Web server 


Web browser.Web client 


MDT eclipse plugin:0M 


SVG interpreterWeb client 


OmPython:OM phpWeb server 


Figura 6.12 Diagrama UML de implementación. Módulos para el desarrollador de modelos y 
experimentos 


6.4 INTERFAZ 
6.4.1 Estructura de páginas 


La interfaz web de UNVirtualLab se estructura como un conjunto de bloques 
anidados. Cada bloque es una región rectangular con una funcionalidad espe- 
cífica. La estructura de la interfaz se define en un archivo XML guardado en 
la carpeta page_structure. Este archivo consta de etiquetas anidadas block 
que contienen las siguientes propiedades: 


= id: nombre que identifica el bloque. 
= type: tipo de elemento HTML que contendrá el bloque. 
= class: nombre de la clase CSS que controla la apariencia del bloque. 


= action: nombre de la clase PHP encargada de desplegar el contenido 
interno del bloque. 


A manera de ejemplo, considérese la figura 6.13 en la que se muestra la 
apariencia de la página about (subfigura 6.13(a)), su estructura de bloques 
(subfigura 6.13(b)) y el código del archivo XML (subfigura 6.13(c)) en el que 
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se define esa estructura*. En esta página se despliega la información de refe- 
rencia de un modelo específico. La página consta de dos bloques, uno anidado 
dentro del otro: 


= Un bloque del tipo body cuya apariencia se controla con la clase CSS 
unv1l; el bloque no tiene contenidos específicos y, por tanto, no hay nin- 
guna clase PHP asociada. 


= Un bloque del tipo table cuya apariencia se controla con la clase CSS 
about; el contenido del bloque lo despliega la clase PHP abouttable. 


Mozilla Firefox 


localhost 


En este experimento se muestran los retratos de fase 
que involucran a la flecha, para evaluar el efecto que 
tienen la comente, la temparatura ambiente y la 
temperatura del conductor sobre la flecha 


[Teoría del modelo 
¡Modeladores [Oscar Duarte (ogduartevMunal.edu.co) 
[CI A 


¿Bajo qué condiciones de operación la flecha 
depende de forma más directa de la coriente? ¿Bajo 


Desarrolle un modelo lineal para la flecha en función 
de la temperatura del conductor, para diferentes 
¡condiciones de operación. 


(a) Página about (b) Estructura de bloques 


<block id=""unvl'' type=""body'' class=""unvl''> 

<block id=""abouttable'' type=""table'' class=" "about'' 
action=""abouttable''> 

</block> 
</block> 


(c) Código XML 


Figura 6.13 Página about. Estructura de bloques y código XML asociado 


Al estructurar las páginas por bloques anidados, se obtienen varias ven- 
tajas en el desarrollo y la administración del sistema: 


= El desarrollo de cada página es modular y ordenado. 


“El código se encuentra en el archivo page_structure/about . xml 
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Se puede obtener un prototipo rápido para evaluaciones preliminares. 
= El posicionamiento de los bloques se puede controlar vía CSS. 


= El control de la apariencia mediante archivos CSS es ordenado 
y modular. 


= El desarrollo modular simplifica la depuración del código. 
= Un mismo bloque puede reutilizarse en diferentes páginas. 


= La presentación de un mismo bloque en páginas diferentes puede con- 
trolarse vía CSS. 


Las figuras 6.14 y 6.15 muestran la manera como se anidan los bloques en 
las páginas de experimentación y administración, respectivamente. La fun- 
ción de cada uno de los bloques definidos en UNVirtualLab se presenta en la 
tabla 6.2. Por otra parte, la figura 6.16 muestra cómo se anidan los bloques de 
las páginas usadas para incrustar (embeber) tanto el modelo como la docu- 
mentación dentro de páginas HTML externas. 


title_frame 


documentation 


credits 


Figura 6.14 Estructura de la interfaz de experimentación 
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Tabla 6.2 Funcionalidad de los bloques de UNVirtualLab 


Bloque (id) Función 
Bloques generales y de experimentación 

anim2d Despliegue de las animaciones en 2D asociadas a la planta de experimentación. 

body Cuerpo principal de la página de experimentación. 

controls Despliegue de los controles de los parámetros de la planta de experimentación 
modificables por el usuario. 

credits Despliegue del enlace a la página de información de referencia de la planta de 
experimentación. 

documentation Despliegue del archivo (pdf) con la documentación de la planta de 
experimentación. 

erase Borrado de los archivos temporales del experimento; este bloque no genera 
código HTML y su efecto es invisible para el experimentador. 

logo Despliegue del logo de UNVirtualLab. 

menu Despliegue del menú de selección de secciones y plantas de experimentación 
en la página de experimentación. 

outputs Elemento contenedor de la presentación de los resultados del experimento. 

plots Despliegue de las curvas de resultados asociadas al experimento. 

tables Despliegue de las tablas de datos con los resultados del experimento. 

title Despliegue del título de la planta de experimentación. 

titleframe Elemento contenedor del título de la planta de experimentación y del enlace a 
la página de información de referencia del mismo. 

unvl Elemento contenedor de la página de experimentación. 


Bloques específicos de administración 


admin_logout 


Despliegue del botón para cerrar la sesión de administración. 


admin_modelfiles 


Despliegue de los controles para cargar los archivos asociados al modelo. 


admin_2danim 


Despliegue del espacio de edición de las animaciones 2D. 


admin_2deffect 


Despliegue del espacio de edición de los efectos de animación 2D. 


admin_control 


Despliegue del espacio de edición de los controles de parámetros. 


admin_login 


Despliegue de la página de inicio de sesión de administración. 


admin_model 


Despliegue del espacio de edición de los modelos de las plantas de 
experimentación. 


admin_practice 


Despliegue del espacio de edición de los experimentos sugeridos. 


admin_plot 


Despliegue del espacio de edición de las curvas de resultados de experimentos. 


admin_section 


Despliegue del espacio de edición de las secciones de plantas de 
experimentación. 


body_admin 


Cuerpo principal de las páginas de administración. 


unvl1_admin 


Elemento contenedor de las páginas de administración. 
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adminmodel 


admin2danim 


admin-logout 


adminpractice 


admin2deffec 


unvl_admin 


admincontrol login 


unvl_admin 


admin. login 


admin 


admin logout 


adminplot 


control 


adminsection 


unvl_admin 


admin_modelfiles 


admin_model 
menu 
admin logout 


unvl_admin 


body.admin 


admin-practices 


admin-logout 


unvl_admin 


unvl_admin 


ladmin.section 


admin-logout 


Figura 6.15 Estructura de las páginas de administración 
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embed doc 


unvi_admin unvl_admin 


body_admin body_admin 


credits 3 : 
bona] 


title 


Figura 6.16 Estructura de la interfaz para embeber el modelo y la documentación 


6.5 IMPLEMENTACIÓN EN PHP 


Los scripts de UNVirtualLab 2.0 han sido escritos en lenguaje php siguiendo 
la metodología de programación orientada a objetos”. Las clases diseñadas se 
pueden agrupar en dos conjuntos: 


= Clases enfocadas en el experimentador: implementan las funcionalida- 
des requeridas por el usuario experimentador (véase figura 6.4); se pre- 
sentan en la sección 6.5.1. 


= Clases enfocadas en el administrador: implementan las funcionalidades 
requeridas por el usuario administrador (véase figura 6.5); se presentan 
en la sección 6.5.2. 


La mayoría de las clases tiene por propósito desplegar y gestionar uno de 
los bloques de la interfaz. La colección de bloques y su disposición en pantalla 
se explican en la sección 6.4. 


6.5.1 Clases enfocadas en el experimentador 


La figura 6.17 muestra la jerarquía de clases enfocadas en el experimenta- 
dor. Como puede observarse, block es la clase principal, que sirve de clase 
abstracta para las demás. Específicamente, block implementa las siguientes 
funciones: 


5 Algunos trozos de software utilizan también lenguaje javascript y ecmascript. 
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Block 1. Realiza la conexión a la base de datos a través de la función 
connect (). 


Block 2. 


Block 3. 


Block 4. 


Block 5. 


Despliega la estructura básica de las páginas HTML a través de la 
función html (). El despliegue se realiza con los siguientes pasos: 


1. 


4. 


Se lee el archivo XML que define la estructura de la página (fun- 
ción readXml ()). 


. Se despliega el encabezado de la página HTML (función 


opener ()). 


. Se despliega la información del bloque definido en el archivo XML 


(función html1Block ()) a través de los siguientes pasos: 


3.1. 
3.2. 


3.3. 


3.4. 


3.5. 


Se despliega la apertura del bloque HTML. 

Se crea un objeto de la clase definida en el archivo XML para 
ese bloque. 

Se invoca la función display () del objeto creado. Esta clase 
es convenientemente redefinida en cada una de las clases he- 
rederas para desplegar la información pertinente. Los tres pa- 
sos anteriores se realizan a través de la función htm1Simple 
Open). 

Se despliega la información de los bloques anidados llaman- 
do de forma iterativa la función htm1Block (). 

Se despliega el cierre del bloque HTML (función html 
SimpleClose()). 


Se despliega el cierre de la página HTML (función closer ()). 


Despliega las cadenas de texto en el idioma adecuado a través de la 
función text (O) (ver sección 6.6.1). 


Captura el identificador del objeto que debe desplegarse, a través de 
la función x_id(). 


Valida que la información proveniente de los formularios correspon- 
da al tipo declarado (función validateValue ()). 


La tabla 6.3 presenta una breve descripción de cada una de las demás cla- 
ses enfocadas en el experimentador, explicando los aspectos relevantes de la 
lógica de implementación. 
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Tabla 6.3 Clases orientadas al experimentador 


Clase Descripción 


abouttable Despliega la información de referencia de un modelo específico. La información 
se presenta como una tabla HTML organizada así: 
= Información general:] Nombre, descripción y bibliografía de referencia 
para el modelo (función displayModel ()). 


=  Modeladores: información sobre los desarrolladores del modelo (función 
displayModellers()). 


= Archivos: enlaces a los archivos descargables asociados al modelo (fun- 
ción displayFiles()). 


= Enlaces para incrustar: código HTML necesario para incrustar el modelo 
y la documentación. También se muestra el enlace directo al archivo pdf 
de documentación. 


= Prácticas: preguntas guías sugeridas como ideas para formular experi- 
mentos alrededor del modelo (función displayPractices()). 


anim2d Despliega cada una de las animaciones 2D asociadas al modelo (función 
displayAnim2d ()), utilizando un objeto de la clase animation2dSVG. 


animation2dSVG | Despliega una animación 2D con los resultados de una simulación. La ani- 
mación se genera en lenguaje SVG. Los pasos que se ejecutan (en la función 
animate0bject()) son: 


1. Seleen los resultados de la simulación. Los resultados están en un archivo 
temporal en formato CSV que se aloja en la carpeta work. Para la lectura 
se utiliza un objeto de la clase csvreader. 


2. Se lee el archivo SVG que será modificado con los datos de la simula- 
ción. Para la lectura se utilizan las funciones de la clase padre MyXm1. La 
estructura se transforma en un árbol implementado con arreglos. 


3. Se leen desde la base de datos las animaciones que son controladas 
por los resultados de la simulación (función readModifications() y 
sync ()). 


4. Se modifica la estructura del árbol con las animaciones correspondientes 
(funciones modify (), modifyXml () e insertAnimation()). 


configuration | Lee el archivo de configuración config/unvlconfig.txt' 


controls Despliega el contenido del bloque que aloja los controles mediante los 
que el experimentador puede modificar los parámetros del modelo (fun- 
ción displayControls()). Cada control se despliega mediante la función 
displayControl1(); si el control es del tipo “select” se emplea la función 
displaySelect(). Los controles utilizan unas funciones en lenguajes Ja- 
vaScript y ECMAScript que se escriben en línea a través de las funciones 
javascript () y ecmascript(). 


credits Despliega el contenido del bloque credits, que contiene un enlace que crea una 
nueva ventana con información de referencia del modelo específico. 


SE] autor de esta clase es Thomas Schmidt. La clase se distribuye bajo licencia libre Apache. Ha sido 
descargada de [link:5]. 
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Tabla 6.3 Clases orientadas al experimentador 


Clase Descripción 


csvreader Lee un archivo de resultados de simulación en formato CSV y genera una arreglo 
PHP con los datos. La función readCsv() devuelve un arreglo de arreglos con 
los datos numéricos de cada variable simulada. La función readSync devuel- 
ve un arreglo de arreglos asociativos con los datos numéricos de cada variable 
simulada en los que la clave es el valor de la variable tiempo (time). 


documentation | Despliega el archivo pdf de documentación asociado al modelo. El archivo 
debe tener por nombre documentation.pdf y debe alojarse en la carpeta 
files/ID/doc, en donde ID es el identificador del modelo. 


erase Borra los archivos temporales que se generan en cada simulación. 
logo Despliega el logo de la aplicación, con un enlace a la página del proyecto. 
menu Despliega el menú de selección de secciones y modelos. Para ello, utiliza un objeto 


de la clase tlistemysql. 


myXml Lee el contenido de archivos en formato XML. Esta clase ha sido construi- 
da a partir de la clase XMLThing, a la que se le han añadido las funciones 
de escritura (writeXmlFile(), writeXmlString, writeNodeAttributes y 
writeNodeString()), inserción de nodos (insertNode ()) y eliminación de 
nodos (removeNode ()). 


outputs Lanza una simulación a través de un objeto de la clase simulator. 


plots Despliega cada una de las gráficas asociadas al modelo (función 
displayPlot ()) utilizando un objeto de la clase SVGpl1ot. 


simulator Ejecuta una simulación con los parámetros definidos por el usuario a través de 
los siguientes pasos (función simulate()): 


1. Se lee desde la base de datos el nombre del archivo ejecutable del modelo 
(función exeFileName ()). 


2. Se lee el archivo de parámetros del modelo original, es decir, del modelo 
sin las modificaciones del usuario (función readInitXml ()). La infor- 
mación se almacena en un árbol. 


3. Se leen desde la base de datos los nombres de las variables que de- 
berán desplegarse después de realizar la simulación; con este con- 
junto se construye el filtro de salida de la simulación (función 
change0utputFilter()). 


4. Se actualizan los valores del árbol de parámetros con los datos seleccio- 
nados por el usuario; estos datos se reciben desde un formulario (función 
changeValues()). 


5. Se asigna un nombre aleatorio (supóngase que es ABCDEF). Se constru- 
ye el archivo de parámetros actualizado work/INI_ABCDEF (función 
writelnitXml (O). 


6. Se corre el archivo ejecutable con el archivo de parámetros actualizado 
y los resultados se salvan en work/INI_ABCDEF_res.csv; el nombre 
de este archivo se almacena en el arreglo de sesión $_POST[] (función 
runSimulation()). 
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Tabla 6.3 Clases orientadas al experimentador 


Clase Descripción 


svgplot Despliega una figura asociada a un modelo con los resultados de una simulación. 
La figura se construye en formato SVG mediante los siguientes pasos: 


1. Se leen los parámetros de dibujo tales como el tamaño de la figura (fun- 
ción settings ()). 


2. Selee desde la base de datos qué curvas deben dibujarse y a qué variables 
simuladas corresponden; los valores numéricos de esas variables se leen 
desde el archivo de resultados usando un objeto de la clase csvreader 
(function data()). 


3. Se despliega el código SVG de la figura (función display ()). 


tables Despliega la tabla con los valores numéricos de las variables simuladas (función 
showTable ()). Para descargar los valores se crea un enlace al script send . php, 
que recibe los datos serializados. 


title Lee desde la base de datos el nombre del modelo y lo despliega en el bloque 
title. 
tlistemysql Despliega el menú anidado de secciones y modelos. La clase ha sido construida 


a partir de la clase PhpTliste que se distribuye con licencia GNU?. 


XMLThing Lee un archivo con formato XMIB, 


6.5.2 Clases enfocadas en el administrador 


Las figuras 6.18 y 6.19 muestran la jerarquía de clases enfocadas en el adminis- 
trador. La clase principal es adminblock, que es heredera de la clase block. 

El propósito fundamental de la clase adminblock es el de gestionar la in- 
terfaz entre el usuario y la base de datos. Esta clase se encarga de desplegar la 
información de la base de datos en formularios y de administrar las actualiza- 
ciones de la información. Cada clase hija se especializa en una tabla específica 
de la base de datos. Para ello, se han definido los siguientes miembros de clase 
que se redefinen en los hijos”: 


a. table: almacena el nombre de la tabla que gestiona. 


b. fields: arreglo que almacena información sobre los campos de la tabla. 
Cada elemento del arreglo es, a su vez, un arreglo con las siguientes claves: 
= dbname: nombre del campo. 


= showname: texto para desplegar en el formulario como nombre del 
campo. 


7El autor de esta clase es Berthou ([link:6]), y se encuentra disponible en [link:7]. 
8Clase desarrollada por <wickedfatherOhotmail.com>y disponible en [link:8]. 
“En el apéndice C se muestra el contenido de estos campos para las clases hijas. 
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connect() 


htmi() 


display() 


adminmodelfiles 


createData() 

copyfile() 

db_modelica() 
db_documentation() 
db_executable() 
readInitXmi() 
varsInInitXmi() 
varsinResCsv() 

inDB() 
updateDBvarsAndPars() 
compareUpdateXMLDB() 
upload() 

display() 

displayFD() 


adminsection 


createFields() 


createRelations1N() 


createFields() 


display() 
readXml() 


adminblock 


update() 

insert() 

delete() 
createFieldsAndRelations() 
createFields() 
createRelations1N() 
createRelations1N1N() 
createRelations1NN1() 
displayAll() 
displayOwn() 
displayFields() 
displayRelations1N() 
displayRelations1N1N() 


displayRelationstNN1() 


Ar 


adminplot 


createFields() 
createRelations1N1N() 
findModella() 
displayRelations1N() 
displayPlot() 


update() 
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databasemanager 


update() 


update1NN1() 


insert() 


insert1NN1() 


delete() 


delete1NN1() 


createDirectories() 
deleteDir() 
deleteDirectories() 


display () 


admin2danim 


createFields() 
createRelationstN() 
createRelationsiN1N() 
findModelld() 
displayRelations1N() 
displayAnim() 


update() 


Y adminmodel 


createFields() 


createRelationstN() 


displayRelationsi1NN1() 


admincontrol 


createFields() 
createRelationsiN1N() 


finsModelld() 


update() 


Figura 6.18 Diagrama UML de clases de administración. Solo se muestran algunas funciones 


= type: tipo de dato. Según el tipo de dato se despliega un control HTML 
específico. Los tipos de datos válidos y los controles asociados se mues- 


tran en la tabla 6.4. 


c. relationsiN: arreglo que almacena el listado de relaciones del tipo 1 + 
oo asociadas a la tabla. Cada elemento del arreglo es, a su vez, un arreglo 


con las siguientes claves: 
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disp 
disp 
disp 
disp 
disp 
disp 


Update() 
insert() 
delete() 
createFiel 
createFiel 
createRel 
createRel 


createRel 


adminblock 


ldsAndRelations() 
ds() 

ations1N() 
ations1N1N() 


ationsiNN1() 


ayAl 


( 


layOwn() 


ayFields() 


layRelations1N() 


ayRelationstN1N() 


layRelations1NN1() 


adminlogout 


sessionManager 


display() 


showMessage() 


showButtons() 


display() 


Figura 6.19 Diagrama UML de clases de manejo de sesiones. Solo se muestran algunas funciones 
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title: texto para desplegar en el formulario como título del grupo. 


table: nombre de la tabla secundaria. 


linkname: nombre base del identificador para usar en el formulario. 


id1: nombre del campo en la tabla primaria de la relación. 


id2: nombre del campo en la tabla secundaria de la relación. 


idvalue: valor del campo en la tabla primaria de la relación. 


showdbname: texto para desplegar en el formulario como nombre de 


la relación. 


show: nombre del campo en la tabla secundaria que contiene el texto 
a desplegar en el formulario como valor actual de la relación. 
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Tabla 6.4 Tipo de datos válidos para editar mediante la clase adminblock y control HTML desplegado 


Tipo de dato Control HTML 

bool <select> con dos opciones 

check <input> del tipo checkbox 

color <input> de la clase color! 

fixed texto no editable 

float <input> 

int <input> 

longtext <textarea> 

model_link <a> enlace al modelo 

select options <select> con opciones definidas mediante un arreglo 

select section <select> las opciones son el contenido de la tabla 
sections 

select variable <select> las opciones son el contenido de la tabla 
variables 

select parameter <select> las opciones son el contenido de la tabla 
parameters 

text input 


d. relations1N1N: arreglo que almacena dos relaciones concatenadas, am- 
bas del tipo 1 + oo asociadas a la tabla. Cada elemento del arreglo es un 
arreglo semejante a los usados en el arreglo relations1N, con una clave 
más, denominada subfields. En esta clave se aloja un arreglo semejante 
a los usados en el arreglo field. 


e. relations1NN1: arreglo que almacena el listado de relaciones del tipo 
00 + 00 asociadas a la tabla. Cada elemento del arreglo es, a su vez, un 
arreglo con las siguientes claves: 

= title: texto para desplegar en el formulario como título del grupo. 
= tableLink: nombre de la tabla de la relación. 

= table2: nombre de la tabla secundaria. 

= linkname: nombre base del identificador para usar en el formulario. 
= id1: nombre del campo en la tabla primaria de la relación. 

= id2: nombre del campo en la tabla secundaria de la relación. 


= idLink1: nombre del campo en la tabla primaria como aparece en la 
tabla de la relación. 


1Utiliza el script jscolor desarrollado en lenguaje javascript por Jan Odvarko ([link:9]), distribuido 
con licencia libre GNU, y disponible en [link:10]. 
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idLink2: nombre del campo en la tabla secundaria como aparece en 
la tabla de la relación. 


showdbname: texto para desplegar en el formulario como nombre de 
la relación. 


show: nombre del campo en la tabla secundaria que contiene el texto 
que se desplegará en el formulario como valor actual de la relación. 


order: nombre de los campos de la tabla secundaria que sirven de 
criterio de ordenamiento ascendente. 


subfields: arreglo semejante a los usados en el arreglo field. 


Específicamente, la clase adminblock implementa las siguientes 
funciones: 


AdminBlock 1. Crea los arreglos que definen los campos y relaciones de cada 


tabla a través de las siguientes funciones que se redefinen en 
cada clase hija: 

= createFieldsAndRelations () 

= createFields() 

= createRelationsiN() 

= createRelations1NiN() 

= createRelations1NM1() 


AdminBlock 2. Actualiza la base de datos con la información proveniente de 


un formulario, a través de las funciones update (), update 
1N1NO) y update1NM1 (). Estas funciones utilizan un objeto 
de la clase databasemanager. 


AdminBlock 3. Crea nuevos campos en la base de datos con instrucciones 


provenientes de un formulario a través de las funciones 
insert () e insert1NWMN1(). Estas funciones utilizan un ob- 
jeto de la clase databasemanager. 


AdminBlock 4. Elimina campos en la base de datos con instrucciones prove- 


nientes de un formulario a través de las funciones delete () y 
delete1NM1(). Estas funciones utilizan un objeto de la clase 
databasemanager. 


AdminBlock 5. Despliega los formularios para edición de información y adi- 
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= displayA11() 

= displayOwn() 

= displayPostOwn() 

= displayRelationsiN() 

= displayOneRelationiN() 

= displayRelationsiNiN() 

= displayOneRelationiNiN() 


= displayRelationsiNM1() 


= displayOneRelationiNM1 () 


URA 


La tabla 6.5 presenta una breve descripción de cada una de las demás 
clases enfocadas en el administrador, explicando los aspectos relevantes de 
la lógica de implementación. 


Tabla 6.5 Clases orientadas al administrador 


Clase Descripción 

admin2danim Clase especializada en la edición de la tabla 2danimations que contiene las 
animaciones en 2D asociadas a un modelo. 

admin2deffect Clase especializada en la edición de la tabla 2deffects que contiene los 
efectos asociados a una animación 2D. 

admincontrol Clase especializada en la edición de las tablas control_groups y controls 
que contienen los controles y grupos de controles mediante los que el usuario 
puede ajustar los parámetros de un modelo. 

adminlogin Despliega el formulario de acceso a las sesiones de administración. 

adminlogout Despliega el formulario de cierre de la sesión de administración. 

adminmodel Clase especializada en la edición de la tabla models que contiene los mode- 
los de simulación. 

adminmodelfiles | Clase especializada en cargar los archivos asociados a un modelo y en actua- 


lizar la información correspondiente en la base de datos. Los tipos de archivo 
que se gestionan son: 
= Ejecutable: un archivo comprimido del tipo .tar.gz que debe con- 
tener tres archivos: el archivo ejecutable (XXX), el archivo con los va- 
lores de los parámetros de simulación XXX_init.xml y el archivo 
con los resultados de una simulación XXX_res.csv. Estos archivos 
se generan usando OpenModelica. Los archivos se guardan en la car- 
peta files/ID/bin, en donde 1D es el identificador del modelo. 


= Documentación: un archivo del tipo .pdf con la documen- 
tación asociada al modelo. El archivo se remombra como 
documentation.pdf y se guardan en la carpeta files/ID/doc. 
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adminmodelfiles 


= Modelica: un archivo del tipo .tar.gz con el código fuente asocia- 
do al modelo (en lenguaje Modelica). El archivo se renombra como 
source.tar.gz y se guarda en la carpeta files/ID/modelica. 


adminplot 


Clase especializada en la edición de las tablas plots y curves que contienen 
las figuras y curvas asociadas a un modelo. 


adminpractice 


Clase especializada en la edición de la tabla practices que contiene los 
experimentos sugeridos asociados a un modelo. 


adminsection 


Clase especializada en la edición de la tabla sections que contiene las sec- 
ciones que sirven para organizar los modelos. 


menuadmin 


Despliega el menú de selección de secciones y modelos. Para ello, utiliza un 
objeto de la clase t1istemysql. 


databasemanager 


Clase especializada en gestionar a bajo nivel la base de datos. Implementa 
las funciones básicas de insertar, actualizar y eliminar registros. También se 
encarga de la gestión de los subdirectorios asociados a cada modelo, que se 
alojan dentro del directorio files 


sessionManager 


Verifica silos datos suministrados en el formulario de inicio de sesión corres- 
ponden o no a un usuario autorizado. En caso afirmativo inicia la sesión. 


6.6 CONFIGURACIÓN DE LA INTERFAZ 


6.6.1 Internacionalización - 118n 


Puede cambiarse el idioma de los textos de la interfaz de UNVirtualLab''. Para 


modificar el idioma deben seguirse los siguientes pasos!”: 


1. Copiar el archivo locale/es.inc o el archivo locale/en.inc en uno 
nuevo de nombre locale/XX.inc, en donde XX es una cadena arbitra- 
ria que identifica el idioma. Se sugiere utilizar el estándar ISO 639 para 


seleccionar el valor de la cadena (véase, por ejemplo, [Int06]). 


2. Traducir las cadenas de caracteres en el nuevo archivo al idioma 
seleccionado. La traducción debe hacerse en las cadenas que están a 
la derecha del caracter “=. 


3. Modificar la opción locale en el archivo config/unvlconfig.txt.La 


> 


línea correspondiente debe quedar así: 


:¡locale = XX 


1 Esto no significa, sin embargo, que UNVirtualLab tenga la opción de manejar simultáneamente con- 


tenidos en diferentes idiomas. El contenido alojado en la base de datos es monolingúe. 


12UN VirtualLab 2.0 incluye los archivos es. inc y en. inc para español e inglés, respectivamente. Por 


tanto, para estos dos idiomas, los dos primeros pasos deben obviarse. 
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6.6.2 Apariencia 


UN VirtualLab utiliza temas especificados en hojas de estilo CSS para definir 
la apariencia de las páginas HTML. Es posible cambiar la presentación de los 
contenidos modificando las especificaciones CSS o creando un nuevo tema. 

Los temas se alojan en el directorio themes. Cada tema debe tener un 
directorio propio cuyo nombre es igual al nombre del tema!*, UN VirtualLab 
busca dentro de esa carpeta las definiciones CSS en dos archivos de nombre 
style.css y styleSVG.css. Se sugiere reservar el archivo styleSVG.css 
para las definiciones asociadas a las figuras SVG que muestran los resultados 
de una simulación. 

Los temas CSS son inherentemente anidados. La anidación de los blo- 
ques CSS que se pueden personalizar en UNVirtualLab a través de los temas 
se muestra en las figuras 6.20 y 6.21. En la primera de esas figuras se presentan 
los bloques de la interfaz para el usuario experimentador, y en la segunda para 
el usuario administrador!*, 

Las definiciones de un bloque contenedor pasan automáticamente a los 
bloques contenidos!”, en donde pueden ser redefinidas. En el apéndice D se 
consignan las definiciones de estilo presentes en el tema unbasic. No obstante, 
un nuevo tema puede definir otros parámetros de apariencia diferentes. 

La organización de la interfaz puede modificarse también a partir 
de especificaciones CSS, ya que el tamaño y la posición de cada bloque 
pueden controlarse por este método. Las figuras 6.22 y 6.23 muestran la 
posición en pantalla de los principales bloques que visualizan los usuarios 
experimentador y administrador, respectivamente, cuando se utiliza el tema 
unvlbasic. 


13 A manera de ejemplo, UNVirtualLab 2.0 tiene por defecto definido el tema unvlbasic en la carpeta 
themes/unvlbasic. 
14 
Se han definido también los bloques div.controlsEmbed div.outputsEmbed y div.documen 
tationEmbed para adecuar la aperiencia de la interfaz cuando se incrusta en páginas HTML exter- 
nas. La estructura de estos bloques es semejante a la de los bloques div.controls div.outputs y 
div.documentation, respectivamente. 


15De allí el término cascada de la sigla CSS, Cascading Style Sheets. 
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table.controls —) body.unvl y 
ttd.controls div.body ) 
div.title_frame ) div.logo ) 

tth.controls 

- div.credits ) img/logo.svg ) 
div.controls_change ) 
- img/info.gif. ) 
input.controls ) 
¡select.controls J div.title ! 


svg.controls ) 


rect.control_back 


div.menu ) 


div.documentation 


div.controls ) div.outputs ) 
div.controls_buttons ) div.plots ) 


rect.control_bar input.controls_buttons 
a div.anim2d ) 


div.controls_change_plus Itable.controls ) div.tables ) 


div.controls_change-minus 


a 


iv.tables div.anim2d ) 
- div.downdata !) div.animation ) 
div.plots 


input.downdata div.animation Title 
svg.plots J 
rect.plot J EE) table.outputs svg file ) 


¡tr.outputs 
rect.frame ) path.curve J 
td.outputsTitle ) 
line.grid ) ltext.legend ) 
td.outputs ) 
ltext.TagH ) lttext.TagV ) 


Figura 6.20 Anidación de los bloques CSS personalizables 


body.unvl ttd.update_value 


input.normalUpdate input.miniUpdate 


div.admin-general 


ttextarea.norma textarea.miniUpdate 


table.update 


th.update_title select.normalUpdate ) select.miniUpdate ) 


td.update_name input.checkUpdate ) 


- itd.update_value 
img/logo.svg ) 


Figura 6.21 Anidación de los bloques CSS personalizables del módulo de administración. 
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CALENTAMIENTO DE CABLES AÉRBOS 
Oscar G- Duarte 


El modelo implementado relaciona el colentomiento y da slengación de un cable 
aéreo desnudo con vorios ospectos: 
O a La corriente eléctrico gue circulo por el conductor. 
o «de Cargabilidad E PE (5) 
o—¿, Catenaria 
od Elongación » Las condiciones de tendido 


Paca traosportar graodes cantidades de ecergía elóctrdca a 
teavós de largas distaccios se utilizan Lfncas de tronemárión co- 
mo las que se muestran 20 la figura 1. La energía elóctelca vlaja 
a tearós de los cobies aéreos, que son conductores de electelcl 


Cargabilidad 


"048 5.18 980 9 19.30 24.0 9.48 
Imax : () vs () O vsQ 


aa 


Figura 6.22 Bloques div principales: 1) div.body, 2) div.logo, 3) div.title_frame, 4) div.menu, 
5) div.documentation, 6) div.controls, y 7) div. outputs 


Corriente 


NO 


Perfil de corriente empleado en la 
simulación 


Actualizar 


Descripción | Parámetro 


Prueba 
Imin (noAli < 


Imax (noAl < 


Imin2 (noA < 


Imax2 (noA < 


Figura 6.23 Bloques div principales del módulo de admimistración: 1) div.body_admin, 2) div.logo, 
3) div.menu, 4) div.admin_logout, y 5) div.admin_general 
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6.6.3 Estilo de las figuras 


Las opciones para modificar la apariencia de las figuras que muestran los re- 
sultados de una simulación pueden clasificarse así: 


a. Definición del tamaño: el tamaño de las figuras se especifica en dos archi- 
vos diferentes (ambos deben modificarse para definir un nuevo tamaño): 


= En el archivo config/unvlconfig.txt, las opciones plotWidth y 
plotHeight definen el ancho y alto de la figura, respectivamente. 


= En el archivo themes/unvlbasic/styleSVG.css (o en el archivo 
correspondiente del tema en uso), las opciones width y height de la 
clase svg. plot definen el ancho y alto del bloque SVG que contiene 
la figura, respectivamente. 


b. Definiciones de cada figura: mediante la interfaz de administrador, es 
posible definir para cada figura de forma independiente los siguientes 
parámetros: 


= Rango de la escala horizontal: puede ser establecido de forma auto- 
mática por UNVirtualLab o definido manualmente por el usuario. 


= Rango dela escala vertical: puede ser establecido de forma automática 
por UNVirtualLab o definido manualmente por el usuario. 


= Número de divisiones horizontales en la grilla. 
= Número de divisiones verticales en la grilla. 


= Color de cada una de las curvas graficadas. 


c. Definiciones del estilo: UNVirtualLab genera las figuras en formato SVG. 
Este formato es inherentemente anidado, lo que significa que las figuras 
se construyen a partir de regiones anidadas. Estas regiones tienen forma 
rectangular, y se muestran en la figura 6.24. El estilo de cada región, a su 
vez, tiene una especificación CSS*S, De esta forma pueden modificarse si- 
multáneamente para todas las figuras parámetros tales como: 


= Color de fondo. 
= Tipo y tamaño de letra. 


= Color y ancho de los trazos. 


16En el tema unvlbasic estas especificaciones se encuentran en el archivo themes/unvlbasic/ 
styleSVG.css. 
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Temperatura de conductor y de aire 


10) 


Temperatura de conductor y de aire 


DIIDO 


Li Lay ATA, 


Tc : (T) vs (hour) 
Ta : (taCelcius) vs (hour) 


b) regiones principales DE 
ZAtitle KPA4plot EA legend frame VMAtagV 


subregiones de la IO 


tagH 


Figura 6.24 Regiones de las figuras asociadas a un modelo 


d. Definiciones de código: la clase svgplot (véase archivo svgplot . php) es- 
tá encargada de dibujar las figuras. En ella se definen los tamaños y las posi- 
ciones de las regiones que se muestran en la figura 6.24. Estas dimensiones 
están dadas como porcentajes de la dimensión de la región contenedora. 
Las dimensiones que pueden modificarse se definen en las líneas de código: 


var $titleHeight=10; 

var $fplotHeight=80; 

var $legendHeight=5; 

var $fframePositionX=20; 
var $fframePositionY=5; 
var $fframeWidth=75; 

var $fframeHeight=85; 

var $tagHeight=10; 

var $ftagWidth=20; 

var $legendSeparation=20; 


/ 


MANUALES 


En este capítulo se presentan los tres manuales desarrollados para UN Virtual 
Lab: un “manual del administrador” (sección 7.1) en el que se detallan las 
tareas de instalación y mantenimiento del sistema; un “manual del modelado” 
(sección 7.2) en el que se presenta una guía para la elaboración de plantas 
experimentales con enfoque pedagógico, y un “manual del experimentador” 
(sección 7.3) en el que se muestra cómo usar las plantas experimentales 
alojadas en UNVirtualLab. Este último manual está complementado con un 
conjunto de videos tutoriales disponibles en línea? 


7.1 MANUAL DEL ADMINISTRADOR 
7.1.1 Instalación del servidor 


UN VirtualLab está diseñado para operar bajo cualquier sistema operativo que 
soporte servidores http, php y mysql. Las instrucciones que se presentan a con- 
tinuación han supuesto que el sistema operativo es Linux y el servidor http es 
apache (ver [Fou05]). Las pruebas se han realizado sobre Ubuntu 16.04. No 
obstante, el procedimiento de instalación es semejante al de cualquier aplica- 
ción web estándar basada en la combinación php y mysql, por lo que no es 
difícil realizar la instalación en otros sistemas operativos. 

Como se explica en la sección 6.3, es posible distinguir tres tipos de ins- 
talación del servidor: 


= Servidor mínimo (véase figura 6.10). 
= Servidor con compilación (véase figura 6.11). 
= Servidor para el modelador (véase figura 6.12). 


En la figura 7.1 se muestra la secuencia de pasos necesaria para instalar un 
servidor UNVirtualLab. Estos pasos de instalación se explican a continuación. 


1. Preparación 2. Configuración 3. Creación de PA 
de servidores : la base de datos EAS 


Figura 7.1 Proceso de instalación de UNVirtualLab 


LA este conjunto de videos se accede haciendo clic sobre el logo de UNVirtualLab y seleccionando la 
opción “Manual del experimentador”. 
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IN.1. Preparación de servidores: 


IN 1.1 Efectuar una instalación estándar del servidor mysq1 ([Cor22]). 
En este proceso de instalación se define el nombre del usuario de 
administración y su clave de usuario. Archivar estos datos para 
usarlos en el paso IN 3.1. 


IN 1.2 Realizar una instalación estándar del servidor php. 
IN 1.3 Realizar una instalación estándar del servidor http apache?. 
IN 1.4 Configurar el servidor http apache: 


IN 1.4.1 Crear o seleccionar un directorio en el que se instala- 
rán los scripts de UNVirtualLab. En el contexto de este 
manual, la ruta del directorio se denomina DIRUNVL. 


IN 1.4.2 Configurar apache para que tenga acceso al directorio 
DIRUNVL. Si el directorio raíz de apache es /var /www 
esto se consigue con los siguientes pasos: 


IN 1.4.2.1 Crear un enlace simbólico: 
ln -s DIRUNVL /var/www/unvl 


IN 1.4.2.2 Editar el archivo sites-available/de 
fault, que usualmente está en el directorio /etc/ 
apache2/, para adicionar el directorio DIRUNVL y 
bloquear el acceso al archivo DIRUNVL/config. Esto 
se consigue adicionando los bloques: 


<Directory DIRUNVL/> 
Options Indexes FollowSymLinks MultiViews 
AllowOverride None 
Order allow,deny 
allow from all 
</Directory> 
<Directory DIRUNVL/config/> 
Allow from None 
Order allow,deny 
</Directory> 


IN 1.4.2.3 Reiniciar el servidor apache 
sudo /etc/init.d/apache2 restart 


IN 1.5 Si se desea realizar una instalación con compilación, es necesario 
instalar el compilador de OpenModelica*: 


2Para algunas distribuciones de Linux, este paso está incluido en la instalación misma del sistema 
operativo. 
3Las instrucciones actualizadas pueden consultarse en [link:11]. 
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IN 1.5.1 Editar el archivo /etc/apt/sources.list para adi- 


cionar la línea: 


deb http://build.openmodelica.org/apt 
“lsb_release -cs” nightly 


IN 1.5.2 Desde una línea de comando, importar la llavet: 
wget -q http://build.openmodelica.org/apt/ 
openmodelica.asc -0- | sudo apt-key add - 
IN 1.5.3 Desde una línea de comando, actualizar el listado de 
repositorios: 
sudo apt-get update 


IN 1.5.4 Desde una línea de comando instalar el compilador: 


sudo apt-get install omc 


Si se desea realizar una instalación para el modelador, la instruc- 
ción del paso IN 1.5.3 debe remplazarse por 


sudo apt-get install openmodelica 


Configuración: se instalan los scripts php de UNVirtualLab y se editan 
los archivos de configuración. Los pasos a seguir son: 


IN 2.1 
IN 2.2 


IN 2.3 


IN 2.4 


Copiar el archivo unv1 .tar.gz en el directorio DIRUNVL 


Descomprimir el archivo unvl.tar. gz 

cd DIRUNVL 

gunzip unvl.tar.gz 

tar -xf unvl.tar 
Como resultado, el archivo unvl1 .php debe estar ubicado como 
DIRUNVL/unvl. php 


Editar el archivo de configuración DIRUNVL/config/unvlcon 
fig.txt. El significado de cada una de las variables de configu- 
ración se consigna en la tabla 7.1. 


Asignar los permisos de lectura adecuados para el archivo de 
configuración. Con las siguientes instrucciones se otorga per- 
miso de lectura solo al usuario dueño del archivo. 


cd DIRUNVL/config 
chmod 444 unvlconfig.txt 


Creación de la base de datos: el script sq1/crearSchema. php se en- 
carga de crear la base de datos mysq1, los usuarios y los permisos ne- 
cesarios. Para ello es necesario conocer el nombre y la clave de acceso 


“La instrucción es un único comando. Se ha escrito en dos líneas por su extensión. 
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mysql de un usuario con permisos de creación y gestión de bases de da- 
tos (típicamente root). Por seguridad, esta información no debe quedar 
disponible en ningún archivo del servidor. Los pasos a seguir son los 
siguientes: 


IN 3.1 Editar el script sq1/crearSchema. php. En las líneas 4 y 5 deben 
editarse las variables Susername y Suserpass para indicar el 
nombre de usuario mysql y la clave de acceso con permisos de 
creación y gestión de bases de datos. Por ejemplo: 


$fusername="root"; 
$fuserpass="rootpassword"; 


IN 3.2 Correr el script sq1/crearSchema. php. 


cd DIRUNVL/sql 
php crearSchema.php 


Este script lee la información de configuración del archivo 
config/unvlconfig.txt y realiza las siguientes tareas: 


a. 


Se conecta con el servidor de la base de datos DBserver usan- 
do el usuario y la clave de acceso definidas en las variables 
$username y Suserpass (archivo sq1/crearSchema. php). 


. Crea una base de datos cuyo nombre está definido por la va- 


riable DBname (archivo config/unvlconfig.txt). 


. Corre el script sq1/unvl.sql que se encarga de crear el sche- 


ma de la base de datos creada en el paso b. 


. Crea un usuario mysql cuyo nombre y clave de acceso están 


definidos por las variables DBuser y DBuserpass, respecti- 
vamente (archivo config/unvlconfig.txt). 


. Le asigna al usuario creado en el paso d permiso para leer re- 


gistros (SELECT) de todas las tablas de la base de datos creada 
en el paso b. 

Crea un usuario mysql cuyo nombre y clave de acceso están 
definidos por las variables DBadmin y DBadminpass, respec- 
tivamente (archivo config/unvlconfig.txt). 


. Le asigna al usuario creado en el paso f permiso para leer, 


crear, editar y eliminar registros (SELECT, UPDATE, INSERT y 
DELETE) de todas las tablas de la base de datos creada en el 
paso b. 


. Crea un usuario UNVirtualLab con rol de administrador cu- 


yo nombre y clave de acceso están difinos en las variables 
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UNVLadmin y UNVLadminpass, respectivamente (archivo 
config/unvlconfig.txt). 


i. Crea una sección de modelos de nombre unvl en la base de 
datos creada en el paso b. 


IN 3.3 Borrar el archivo sq1/crearSchema. php. 
rm DIRUNVL/sql1/crearSchema.php 


IN.4. Pruebas: las pruebas iniciales verifican que UNVirtualLab se encuen- 
tre disponible en la red, y que el acceso al usuario administrador esté 
habilitado. 


IN 4.1 Utilizando un programa navegador web, cargar la dirección 
definida por la variable URLbase (archivo config/unvlcon 
fig.txt). El resultado debe ser la pantalla de navegación para 
el experimentador que se muestra en la figura 7.2. El mismo 
resultado debe obtenerse si se carga la dirección seguida de 


unvl.php. 
[Errp7/1ocaos/oe 
de [0 localhost, y O] (Er Gooc AaLAS 
VirtualLab U.N. 


unv 


Figura 7.2 Pantalla de UNVirtualLab para el usuario experimentador, inmediatamente después de una 
instalación fresca 


IN 4.2 Utilizando un programa navegador web, cargar la dirección de- 
finida por la variable URLbase seguida de admin. php. El resul- 
tado debe ser la pantalla de inicio de sesión de administración 
que se muestra en la figura 7.3. 
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de http://localhost/unv/admir 


e [8 localhost/unv/admin.php 


Figura 7.3 Pantalla de UNVirtualLab para inicio de sesión de administrador, inmediatamente después de 
una instalación fresca. 


IN 4.3 A partir de la página del numeral anterior, iniciar una sesión uti- 
lizando como nombre de usuario y clave de acceso las variables: 
UNVLadmin 
UNVLadminpass 
Estas variables están definidas en el archivo config/unvl 
config.txt. El resultado debe ser la pantalla de navegación pa- 
ra el administrador que se muestra en la figura 7.4. Seleccionar 
la única opción del menú de navegación (unvl), agregar una sec- 
ción hija de nombre “Pruebas” y seleccionarla en el menú. 


de http://localhost/unv/admis 
€ [8 localhos 


Figura 7.4 Pantalla de UNVirtualLab para el usuario administrador con sesión abierta, inmediatamente 
después de una instalación fresca 
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IN 4.4 Importar el modelo de prueba de un Motor DC: 
cd DIRUNVL/samples 
php importModel .php motorDC/motorDCExport.txt 
IN 4.5 En la página de edición del modelo “Motor DC”, hacer click so- 
bre el ícono que está a la derecha del letrero “Documentación 
(.pdf)”, seleccionar el archivo DIRUNVL/samples/motorDC/ 
MotorDC. pdf y enviarlo. 


IN 4.6 Pruebas de simulación 


Para una instalación mínima: 

IN 4.6.1 En la página de edición del modelo “Motor DC”, 
hacer click sobre el ícono que está a la derecha del 
letrero “Ejecutable (.tar.gz)”, seleccionar y enviar el 
archivo: DIRUNVL/samples/Min/DCmotorMini 
mal.tar.gz 

IN 4.6.2 Enla página de edición del modelo “Motor DC) ha- 
cer click sobre el ícono que está a la derecha del 
letrero “Modelica (.tar.gz)”, seleccionar y enviar el 
archivo  DIRUNVL/samples/Min/DCmotorMini 
malSource.tar.gz 

Para una instalación con compilación: 

IN 4.6.1 En la página de edición del modelo “Motor DC”, 
hacer click sobre el ícono que está a la derecha del 
letrero “Ejecutable (.tar.gz)”, seleccionar y enviar 
el archivo DIRUNVL/samples/Compila/DCmotor 
Compila.tar.gz 

IN 4.6.2 En la página de edición del modelo “Motor DC”, 
hacer click sobre el ícono que está a la derecha del 
letrero “Modelica (.tar.gz)”, seleccionar y enviar el 
archivo  DIRUNVL/samples/Compila/DCmotor 
CompilaSource.tar.gz 

Para una instalación para modelador: 

IN 4.6.1 Utilizando OMShe11, compilar el modelo del archi- 
vo DIRUNVL/samples/Modelador/DCMotor .mo y 
simular el modelo con salida en formato CSV me- 


diante las siguientes instrucciones: 
loadModel (Modelica) 
cd DIRUNVL/samples/Modelador 
loadFile("DCmotor.mo"); 
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simulate(DCmotor, startTime=0, stopTime=10, 
outputFormat="csv"); 


IN 4.6.2 Crear un archivo comprimido en formato .tar.gz 
con los archivos: 
= DCmotor 
= DCmotor_init.xml 
= DCmotor_res.csv 
Estos archivos son creados por OMShell como par- 
te del proceso de simulación. Para efectos de esta ex- 
plicación, se supondrá que el nombre dado al archi- 
vo comprimido es DCmotorModelador.tar.gz. 

IN 4.6.3 Crear un archivo comprimido en formato .tar.gz 
con el archivo DCmotor.mo. Para efectos de esta 
explicación, se supondrá que el nombre dado al ar- 
chivo comprimido es: DCmotorModeladorSour 
ce.tar.gz. 

IN 4.6.4 En la página de edición del modelo 'Motor DC; 
hacer click sobre el ícono que está a la derecha del 
letrero “Ejecutable (.tar.gz), seleccionar y enviar 
el archivo DIRUNVL/samples/Modelador/DCmo 
torModelador.tar.gz. 

IN 4.6.5 En la página de edición del modelo “Motor DC, 
hacer click sobre el ícono que está a la derecha 
del letrero Modelica (.tar.gz)” seleccionar y enviar 
el archivo DIRUNVL/samples/Modelador/DCmo 
torModeladorSource.tar.gz. 


IN 4.7 Utilizando un programa navegador web, cargar la dirección 
definida por la variable URLbase (archivo config/unvlcon 
fig.txt) y seleccionar el modelo “Motor DC”. El resultado 
debe ser la pantalla de navegación para el experimentador que 
se muestra en la figura 7.5. 


IN 4.8 Modificar el valor del parámetro “Resistencia” con la interfaz, y 
lanzar una simulación. 
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Tabla 7.1 Variables de configuración de UNVirtualLab en el archivo config/unvlconfig.txt 


Variable Significado Valor por 
defecto 
locale Idioma de la interfaz. Es el nombre del archivo .inc | es 
con los mensajes que se despliegan. El archivo debe 
estar ubicado en el directorio locale. 
theme Configuración de la apariencia. Es el nombre del | unvlbasic 
subdirectorio que contiene las especificaciones CSS. 
El subdirectorio debe estar ubicado dentro del di- 
rectorio themes 
plotWidth Ancho en pixeles de las figuras que muestran los re- | 300 
sultados de las simulaciones. 
plotHeight Altura en pixeles de las figuras que muestran los re- | 200 
sultados de las simulaciones. 
aboutWidth Ancho en pixeles de la ventana que despliega infor- | 400 
mación de referencia de los modelos. 
aboutHeight Altura en pixeles de la ventana que despliega infor- | 400 
mación de referencia de los modelos. 
DBserver Dirección del servidor de la base de datos mysq]. localhost 
DBname Nombre de la base de datos. unvl 
DBuser Nombre del usuario mysql con acceso a lectura de | unvlvisitor 
registros en la base de datos. 
DBuserpass Clave de acceso del usuario mysql con acceso alec- | unvlvisitor 
tura de registros en la base de datos. 
DBadmin Nombre del usuario mysql con acceso a edición, in- | unvladmin 
serción y eliminación de registros en la base de da- 
tos. 
DBadminpass Clave de acceso del usuario mysql con acceso aedi- | unvladmin 
ción, inserción y eliminación de registros en la base 
de datos. 
UNVLadmin Nombre del usuario UNVirtualLab con rol deadmi- | adminUNVL 
nistrador. 
UNVLadminpass Clave de acceso del usuario UNVirtualLab con rol | adminpassword 
de administrador. 
URLbase Dirección URL de acceso a UNVirtualLab. localhost/unvl 
unvlDir Directorio en que está alojado UN VirtualLab. [var/www/unvl 
Compilation Si esta variable toma el valor TRUE, entonces los ar- | TRUE 
chivos que se suban como ejecutables serán descom- 
primidos, compilados y copiados en el directorio del 
modelo. De lo contrario, solo serán descomprimi- 
dos y copiados. 
CompilationOrder Instrucción de compilación que se utiliza si la varia- | omc 
ble Compilation toma el valor TRUE. 
CompilationPostOrder | Complemento a la instrucción de compilación. >/dev/null 
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db htto://localho....pho?modelid=1 
€ [9 localhost + €] [Bl- Googe CI 


VirtualLab U.N. 


e und 
-d Motor DC E 


: 
v 


Potencias 


vos». 


2d 


Figura 7.5 Pantalla de UNVirtualLab para el usuario experimentador, despues de la instalación del 
ejemplo de Motor DC 


7.1.2 Copias de seguridad 


Una copia de seguridad (BK) de UNVirtualLab incluye dos aspectos: un vol- 
cado de la base de datos y una copia de los archivos: 


BK 1. El volcado de la base de datos puede efectuarse desde consola mediante 
la utilidad mysql1dump: 
mysqldump -u DBadmin -pDBadminpass --add-drop-table DBname > dumpfile 
En donde DBadmin, DBadminpass y DBname están definidos en el ar- 
chivo config/unvlconfig.txt, y dumpf ile es el nombre del archivo 
que contendrá el volcado de la base de datos. 
BK 2. La copia de los archivos puede realizarse desde consola así: 


cd DIRUNVL 
tar -cf backUnvl. 
gzip backUnvl.tar 


en donde DIRUNVL es el directorio de instalación, y backUnvl es la ba- 
se del nombre del archivo de backup. El archivo generado tendrá por 
nombre backUnvl.tar.gz. 


7.1.3 Exportación e importación de modelos 


UN VirtualLab cuenta con dos scripts para exportar (EX) e importar (IM) la 
información que reside en la base de datos de un modelo específico. El proceso 
de exportación es el siguiente: 
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EX 2. 


EX 3. 


EX 4. 


EX 5. 


EX 6. 
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Desde la ventana de administración del modelo, averiguar cuál es el 
identificador del modelo. Este es el número que aparece en la tabla de 
información general del modelo en la casilla “Identificador”. 


Desde consola, exportar el modelo con la siguiente secuencia de ins- 
trucciones (modID es el identificador del modelo, y filename un nom- 
bre arbitrario para el modelo): 


cd DIRUNVL/samples 
php exportModel.php modID > filename 


Crear el archivo comprimido del ejecutable. Los archivos que se deben 
comprimir varían según el tipo de instalación de destino (mínima, con 
compilación o para modelador. Véase sección 7.2.4): 


DIRUNVL/files/modID/bin/ 


Obtener una copiar del archivo de documentación: 


DIRUNVL/files/modID/doc/documentation.pdf 


Obtener una copiar del archivo del código fuente: 
DIRUNVL/files/modID/modelica/source.tar.gz 

Obtener una copiar de los archivos SVG de animación que estén en la 
carpeta: 


DIRUNVL/fi1les/modID/graphics 


Para importar el modelo en otra instalación de UN VirtualLab, el proce- 
dimiento es el siguiente: 


IM.1. 


IM.2. 


IM.3. 


Desde la consola, importar el modelo con la siguiente secuencia de ins- 
trucciones (filename es el nombre del archivo en el que se ha exporta- 
do el modelo): 


cd DIRUNVL/samples 
php importModel .php filename 


Desde la ventana de administración de modelos, cargar los archivos eje- 
cutables, fuente y de documentación. 


Desde la ventana de administración de modelos, cargar los archivos 
SVG para animaciones. 


269 


UNVIRTUALLAB. Un LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


7.2 MANUAL DEL MODELADOR 


El modelador tiene una responsabilidad múltiple en la producción del material 
alojado en UNVirtualLab. Los tres productos que debe elaborar son: 


= El modelo en Modelica que implementa la simulación. 


= Las plantas de experimentación en UNVirtualLab que permiten la inter- 
acción del usuario experimentador con el modelo. 


= La documentación en formato PDF, tanto del modelo como de las plan- 
tas de experimentación, destinada al usuario experimentador. 


= Unlistado de experimentos sugeridos para ser desarrollados por el usua- 
rio experimentador. 


La figura 7.6 ilustra el proceso sugerido al modelador: la producción del 
modelo, de las plantas experimentales y de los experimentos se realiza en ci- 
clos iterativos de mejoramiento; en cada etapa se actualiza la documentación 
correspondiente. 


Diseñar ON» 


Figura 7.6 Proceso iterativo de modelado 


En cada uno de los ciclos de modelado esbozados en la figura 7.6, el mode- 
lador debe realizar varias actividades que generan ciertos productos, tal como 
se ilustra en la figura 7.7. Estos productos se explican a continuación. El proce- 
so puede iniciarse desde cualquiera de las entradas marcadas por líneas pun- 
teadas; a efectos de la siguiente explicación, se supondrá que se inicia desde la 
definición de objetivos del OVA. Para facilitar la comprensión, dicha explica- 
ción se acompaña de un mismo ejemplo que evoluciona a cada paso. 
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O Actividad Producto D Herramienta 


Figura 7.7 Un ciclo de modelado 


7.2.1 Objetivos del OVA 


Independientemente del uso final que tenga una instalación específica de 
UN VirtualLab, cada uno de los experimentos y cada una de las prácticas en 
esa instalación se pueden considerar como Objetos Virtuales de Aprendizaje 
(véase [Dua09]). El modelador debe especificar cuál es el propósito para el que 
se diseña dicho OVA. 


Ejemplo 7.1: Objetivos de aprendizaje. 


Se desea ilustrar mediante una simulación el funcionamiento de un motor 
eléctrico DC. Específicamente, se formulan los siguientes objetivos de apren- 
dizaje: 


= Reconocer el impacto de la carga mecánica en las variables eléctricas. 


= Identificar el efecto de los parámetros eléctricos y mecánicos en los tiem- 
pos de respuesta. 


= Identificar los procesos de transformación de potencia y energía. 
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7.2.2 Especificaciones funcionales 


El modelador debe definir lo que debe hacer el modelo. Esta definición incluye 
la identificación de las principales variables y parámetros involucrados. 


Ejemplo 7.2: Especificaciones funcionales. 


El modelo debe simular el comportamiento de un motor DC acoplado a una 
carga mecánica. Específicamente debe simularse el comportamiento de las si- 
guientes variables físicas: 


= Diferencia de potencial eléctrico en cada uno de los elementos eléctricos 
del sistema. 


= Corriente eléctrica en cada uno de los elementos eléctricos del sistema. 
= Torque en cada uno de los elementos mecánicos del sistema. 
= Velocidad angular en cada uno de los elementos mecánicos del sistema. 
= Potencia y energía en cada uno de los elementos del sistema. 
El modelo debe incorporar los siguientes parámetros físicos: 
= Resistencia eléctrica e inductancia eléctrica del motor. 
= Factor de conversión electromagnética. 
= Momento de inercia de la carga mecánica. 
El modelo debe incorporar los siguientes parámetros de simulación: 


= Tiempo de simulación. 


7.2.3 Modelo 


Utilizando OpenModelica, el modelador debe implementar la simulación en 
un modelo ejecutable. Debe tenerse especial atención en la definición de las 
unidades de las variables para que estas sean adecuadamente desplegadas por 
UN VirtualLab. El módulo Slunits de la Modelica Standard Library incluye 
una gran colección de unidades listas para su incorporación en los modelos. Si 
el modelador requiere una definición propia de sus unidades en una variable 
específica, puede usar la propiedad unit del tipo de datos Real. Por ejemplo, 
si el usuario requiere definir la variable t para medir el tiempo en años, puede 
emplear el siguiente código 
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Real t (unit="Year") "Tiempo"; 


Una vez simulado el modelo, es necesario ubicar los archivos ejecutable, 
de entrada y de salida generados por OpenModelica. 


Ejemplo 7.3: Modelado. 


El modelo propuesto es muy similar al tutorial que incluye OpenModelica. Los 
pasos a seguir son: 


1. Crear el modelo DCmotor a partir del código que se muestra en el cuadro 
correspondiente al archivo DCmotor.mo 


2. Simular el modelo, empleando como formato de salida csv. Por ejemplo, 
utilizando la herramienta OMShe11 de OpenModelica la secuencia de ins- 
trucciones será (debe sustituirse path por el directorio en el que se encuen- 
tre el archivo DCmotor .mo): 

loadModel (Modelica) ; 
cd("path") 
loadFile("DCmotor.mo"); 


simulate(DCmotor,outputFormat="csv",stopTime=10); 
plot (Pj); 


3. Copiar en alguna carpeta los siguientes archivos generados por OpenMo- 
delica”: 
= DCmotor (o DCmotor . exe si el sistema operativo es windows) 
= DCmotor_init.xml 


= DCmotor_res.csv 


5En una instalación estándar de UNVirtualLab sobre linux, los archivos generados por OMEdit se 
ubican en la carpeta temporal /tmp/OpenModel ica/OMEdit; los archivos generados por OMShel11 se ubi- 
can en en la misma carpeta del archivo fuente Modelica. 
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Archivo 7.1 DCmotor.mo 


model DCm 
Modelica 


Modelica. 
Modelica. 
Modelica. 


Modelica 


Modelica. 
Modelica. 
Modelica. 
Modelica. 
Modelica. 
Modelica. 
Modelica. 
Modelica. 


equation 


otor 


. Electrical 
Electrical 
Electrical 
Electrical 


.Analog. Basic. Resistor R(R = 1); 

. Analog. Basic .Inductor L(L = 0.01); 
. Analog. Basic .EMF emf(k = 1); 

. Analog. Basic .Ground g; 


.Blocks.Sources.Step step(height = 12); 


Slunits 
Slunits 
Slunits 
Slunits 
Slunits 


Slunits. 


. Power 
. Power 
. Power 
. Power 
. Power 


connect(L.n,emf.p); 
connect(R.n,L.p); 
connect(SV.p,R.p):; 
connect(SV.n,g.p); 
connect(emf.n,g.p); 
connect(step.y,SV.v); 
connect(emf.flange ,J.flange_b); 


Psv = 
Pr = 
Pl = 
Pj = 


alfa=der 


SsV.v 
R.v 
Ly 


* SV.i; 


* R.i; 
e 


J.flange_b. tau 
PT=Psv+Pr+Pl+Pj+PT; 


(J-w; 


end DCmotor; 


Psv ”Potencia en la fuente”; 


Pr 
Pl 
pj 
PT 


> 


» a a A 
Potencia en la resistencia”; 
”Potencia en la inductancia”; 


Potencia en la carga mecánica”; 


” Potencia total”; 


A 


Mechanics. Rotational.Components. Inertia J(J = 1); 
Electrical. Analog.Sources.SignalVoltage SV; 


» 
> 


AngularAcceleration alfa ”Aceleración angular”; 


7.2.4 Archivos comprimidos 


UN VirtualLab requiere dos archivos comprimidos para cada experimento. En 
ambos casos, el formato de compresión requerido es .tar.gz. Los archivos 


requeridos son: 


= Archivo comprimido del código fuente: contiene todos los archivos con 
código fuente del modelo. Este archivo sólo se utiliza como fuente de 
información para el usuario, en caso de que desee simular por su cuen- 
ta el modelo, o realizarle modificaciones. Por tanto, la forma en que se 
organice el contenido del archivo comprimido no es crítica para el fun- 


cionamiento de UNVirtualLab. 


= Archivo comprimido del ejecutable: contiene todos los archivos necesa- 
rios para que UNVirtualLab corra la simulación. El contenido que debe 


tener depende del tipo de instalación de UNVirtualLab, así: 
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+ Instalación mínima: el archivo comprimido debe contener tres 
archivos: 
a. El archivo ejecutable del modelo. 
b. El archivo de entrada, cuyo nombre termina en _init.xml. 


c. El archivo de salida, cuyo nombre termina en _res.csv. 
» Instalación con compilación: el archivo comprimido debe contener: 


a. Unarchivo con extensión .mos con la secuencia de instrucciones 
OpenModelica para compilar y simular el modelo. Debe haber 
sólo un archivo con extensión .mos. 


b. Todos los archivos con código fuente necesarios para compilar 
el modelo. 


+ Instalación para modelador: el contenido debe ser igual al de una 
instalación con compilación. 


Ejemplo 7.4: Preparación de archivos. 


Crear un archivo de texto de nombre DCmotorUNVL.mos con el siguiente 
contenido: 


loadModel (Modelica) ; 
loadFile("DCmotor.mo"); 
simulate(DCmotor, startTime=0, stopTime=10,outputFormat="csv"); 


Crear un archivo comprimido en formato .tar.gz con los archivos: 


= DCmotor.mo 


= DCmotorUNVL.mos 


Para efectos de este ejemplo, se supondrá que el nombre dado al archivo com- 
primido es DCmotorSource.tar.gz 


Crear un archivo comprimido en formato .tar.gzcon el archivo DCmotor.mo. 
Para efectos de este ejemplo, se supondrá que el nombre dado al archivo com- 
primido es: DCmotorSource.tar.gz 
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7.2.5 Plantas de experimentación 


En el contexto de UNVirtualLab, una planta de experimentación está asociada 
a un único modelo ejecutable. De manera análoga a las plantas físicas de expe- 
rimentación, las plantas en UNVirtualLab están dotadas de instrumentos que 
permiten controlarlas y visualizar sus comportamientos. Es responsabilidad 
del modelador el diseño de tales instrumentos. 

La figura 7.8 muestra en un diagrama el tipo de instrumentos asociados 
a una planta de experimentación UNVirtualLab. Hay una primera clasifica- 
ción en instrumentos de control y de visualización. Los primeros permiten 
modificar las condiciones de la simulación, mientras los segundos permiten 
visualizar los resultados de esta. 


Conor] — [Grupos] — comal] 


Eje horizontal 


[Instrumentos] A 
Archivo SVG 


[Visualización] — ma 


a 


Figura 7.8 Instrumentos asociados a un experimento 
El modelador debe decidir el número de controles, así como un conjunto 


de propiedades asociadas a cada uno de ellos. La tabla 7.2 muestra las propie- 
dades asociadas a cada tipo de control con una descripción de su significado. 


Tabla 7.2 Propiedades de los controles de cada experimento 


Grupos de Controles 


Propiedad Explicación 

Nombre Nombre asignado al grupo de controles. 

Descripción Descripción que se visualiza al llevar el cursor al nombre del 
grupo de controles. 
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Habilitado Variable que permite mostrar u ocultar al experimentador el 
grupo de controles. 
Controles 
Propiedad Explicación 
Nombre Nombre asignado al control. 
Valor Valor por defecto que toma la variable asociada al control. 
Habilitado Variable que permite mostrar u ocultar al experimentador el 
control. 
Mínimo Valor mínimo permitido para el parámetro asociado al control. 
Máximo Valor máximo permitido para el parámetro asociado al control. 
Incremento Valor en que se incrementa/decrementa el parámetro asociado 


al control al momento de pulsar los botones de incremento/- 
decremento 


Valores permitidos 


Listado de valores y etiquetas para utilizar controles de tipos 
select. Cada opción debe terminar en el carácter 5 y conte- 
ner una pareja “valor” - “etiqueta” separados por el caractér “/. 
El valor es el dato que leerá el modelo, y la etiqueta es lo que se 
visualizará en pantalla. Por ejemplo: *1.0/uno;2.0/dos;3.0/tres”. 
Para que se active el control tipo select es necesario que haya 
al menos una opción válida. 


Descripción Descripción que se visualiza al llevar el cursor al nombre del 
grupo de controles 
Parámetro Parámetro del modelo asociado al control. 
Figuras 
Propiedad Explicación 
Nombre Nombre asignado a la figura y título de la misma 
Descripción Descripción que se visualiza al llevar el cursor sobre la figura. 
Habilitado Variable que permite mostrar u ocultar al experimentador la 


figura. 


Variable horizontal 


Variable del modelo asociada al eje horizontal de la figura. 


Valor mínimo de la variable hori- 
zontal 


Valor mínimo en la escala horizontal (la opción de autoescala 
horizontal debe estar deshabilitada). 


Valor máximo de la variable hori- 
zontal 


Valor máximo en la escala horizontal (la opción de autoescala 
horizontal debe estar deshabilitada). 


Divisiones horizontales 


Número de divisiones horizontales para la grilla de la figura. 


Auto-escala horizontal 


Si esta opción se habilita, entonces la escala horizontal toma un 
rango calculado a partir de los resultados de la simulación. 


Valor mínimo de la variable vertical 


Valor mínimo en la escala vertical (la opción de autoescala ver- 
tical debe estar deshabilitada). 


Valor máximo de la variable vertical 


Valor máximo en la escala vertical (la opción de autoescala ver- 
tical debe estar deshabilitada). 


Divisiones verticales 


Número de divisiones verticales para la grilla de la figura. 


Auto-escala vertical 


Si esta opción se habilita, entonces la escala vertical toma un 
rango calculado a partir de los resultados de la simulación. 


Primer dato 


Número de datos de la simulación que serán ignorados para el 
trazado de las curvas. 


Curvas 
Propiedad Explicación 
Nombre Nombre asignado a la figura. No se visualiza para el experimen- 
tador. 
Leyenda Nombre corto que aparecerá como leyenda de la curva en la 


figura. 
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Habilitado Variable que permite mostrar u ocultar al experimentador la 
curva. 
Descripción Descripción que se visualiza al llevar el cursor al nombre de la 


curva en la leyenda. 


Variable vertical 


Variable del modelo asociada al eje vertical de la figura para la 
curva. 


Color Color con el que se trazará la curva y con el que se escribirá su 

leyenda. 
Animaciones 

Propiedad Explicación 

Nombre Nombre asignado a la animación y título de esta. 

Descripción Descripción que se visualiza al llevar el cursor sobre la anima- 
ción. 

Habilitado Variable que permite mostrar u ocultar al experimentador la 
animación. 

Duración Tiempo de duración de la animación. Si toma un valor no po- 


sitivo, la duración será igual al tiempo de simulación. 


Tiempo de muestreo 


Tiempo de muestreo para generar la animación. 


Archivo SVG Nombre del archivo SVG de la simulación. 
Efecto 
Propiedad Explicación 
Nombre Nombre del efecto. No se despliega. 
Descripción Descripción del efecto. No se despliega. 
Habilitado Variable que permite mostrar u ocultar al experimentador el 
efecto. 
Tipo Tipo de efecto de animación. “single, una variable controla el 


efecto; “double, dos variables controlan el efecto; “path, trayec- 
toria en 2D en la que dos variables controlan las coordenadas 
x,y respectivamente; “text, cambio de un texto (no implemen- 
tada); “color, un color es controlado por una variable. 


Identificador de animación SVG 


id interno del efecto del archivo SVG que será controlado. 


Variable de control 


Primera variable de control del efecto. 


Variable auxiliar 


Segunda variable de control para los efectos tipo “double” y 
“path. 


Offset 


Valor de offset para control del efecto. 


Escala 


Valor de amplificación de la variable simulada para controlar 
el efecto. 


Color RGB mínimo 


Color correspondiente al valor mínimo de la variable. Válido 
para efectos tipo “color”. 


Color RGB máximo 


Color correspondiente al valor máximo de la variable. Válido 
para efectos tipo “color”. 


Valor mínimo de color 


Valor de la variable asociado a la variable Color RGB mínimo. 
Válido para efectos tipo “color”. 


Valor máximo de color 


Valor de la variable asociado a la variable Color RGB máximo. 
Válido para efectos tipo “color”. 
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Ejemplo 7.5: Planta de experimentación. 


Para satisfacer los objetivos del OVA, se ha diseñado una planta de experi- 
mentación con varios instrumentos. Las propiedades especificas de cada ins- 
trumento se muestran en la tabla 7.3, mientras que el diseño de las anima- 
ciones se explica en la sección 7.2.6. Los instrumentos implementados son los 
siguientes: 


a. Instrumentos de control: tres grupos de controles con un total de cinco 
controles: 


= Parámetros mecánicos: inercia de la carga mecánica. 


= Parámetros eléctricos: resistencia del motor, inductancia del motor, 
constante de conversión electromagnética. 


= Parámetros de simulación: tiempo de simulación. 


b. Instrumentos de visualización: tres figuras y una animación. En las figuras 
se grafican un total de 10 curvas, y en la animación se visualiza el compor- 
tamiento de dos variables: 


= Figuras: 
+ Variables eléctricas: se grafica el comportamiento de la corriente, 
la tensión en la inductancia y la tensión electromagnética. 


+ Variables mecánicas: se grafica el comportamiento de la velocidad 
angular, la aceleración angular y el par mecánico. 


+ Potencias: se grafica el comportamiento de la potencia en la fuen- 
te eléctrica, en la carga mecánica, en la resistencia y en la 
inductancia. 


= Animación: 


+ Mediante un sensor de aguja se visualiza el comportamiento de 
la velocidad angular. 


+ Mediante un sensor de barra se visualiza el comportamiento de 
la potencia mecánica. 
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7.2.6 Animaciones 


Para implementar las animaciones en 2D, UNVirtualLab aprovecha el po- 
tencial de animación (AN) de los archivos gráficos en formato SVG!. Para 
implementar una animación en UNVirtualLab, el modelador debe seguir los 
siguientes pasos: 


AN l. 


AN 2. 


AN3. 


AN 8. 


Construir un gráfico en formato SVG. Debido a que el formato SVG es 
una extensión del formato XML, el archivo puede construirse desde un 
editor de texto. No obstante, existen herramientas gráficas de dibujo 
que facilitan esta tarea. Dentro de las herramientas de software libre, 
se destaca inkscape (véase [d131]). Otra herramienta útil de software 
libre es scour (ver [Sch31]), que simplifica el contenido de archivos 
SVG creados con herramientas gráficas. 


Identificar el elemento gráfico que se desea animar. Si son varios ele- 
mentos los que se desean animar con una misma variable de control, 
conviene agruparlos como un único elemento. Para ello puede em- 
plearse la marca <g></g> del lenguaje SVG. 


Construir el efecto de animación del elemento con datos ficticios y 
asignar a esa animación un identificador. A manera de ejemplo, se su- 
pondrá aquí que el identificador asignado es id_efecto. En la sección 
7.2.6.1 se muestra como construir algunos efectos de animación. 


. En la página de administración del modelo, crear una nueva ani- 


mación 2D. 


. En la página de administración de la animación, cargar el archivo SVG. 
. En la página de administración de la animación, crear un nuevo efecto. 


. En la página de administración del efecto, editar la propiedad Identi- 


ficador de animación SVG para asignar el identificador del efecto de 
animación (id_efecto). 


En la página de administración del efecto, ajustar las demás propieda- 
des hasta tener el efecto de animación deseado. En especial, es necesa- 
rio ajustar los valores de Offset y Escala para traducir los resultados 


6Scalable Vector Graphics. Para una introducción al tema pueden consultarse los numerosos tutoriales 
disponibles en la red, por ejemplo [DHH02]. Las animaciones SVG son implementadas por los navegadores 
web; por esta razón, para poder visualizar las animaciones de UNVirtualLab es necesario emplear un na- 
vegador web que soporte las animaciones SVG. Hoy en día, esto no constituye una limitación importante, 
debido a que incluso la mayoría de los navegadores para dispositivos móviles lo hacen. 
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de la simulación en valores gráficos de la animación. Los valores gráfi- 
cos de la animación serán pixeles o grados, según el tipo de animación. 
Si se denota por X»+s los resultados de la simulación, y por Xan los 
valores gráficos de la animación, estos se calculan así: 


Xani = Offset + (Escala x Xpes) (7.1) 


7.2.6.1 Algunos efectos de animación SVG 


La tabla 7.4 muestra algunos efectos de animación con gráficos SVG. A partir 
de un rectángulo base, se presentan los siguientes efectos: 


a. Desplazamientos: pueden realizarse desplazamientos en cada uno de los 
dos ejes, o de forma combinada a lo largo de una trayectoria. 


b. Rotaciones: la animación de rotación por defecto es alrededor del punto 
(0, 0). El efecto de rotar alrededor de un punto p se puede conseguir en tres 
pasos: 1) trasladando el elemento al punto (0, 0); 2) efectuando la rotación 
deseada y; 3) trasladando el objeto rotado al punto p. 


c. Cambio de atributos: pueden modificarse el largo y ancho del rectángulo, 
así como su color y otras propiedades gráficas. 


d. Animación de textos: el estándar SVG no prevee una animación de textos. 
Sin embargo, puede emplearse la animación del atributo “opacity” ('opa- 
cidad”) para conseguir este efecto. UNVirtualLab 2.0 no implementa este 
efecto, pero se presenta aquí a título informativo. 


Tabla 7.4 Ejemplo de implementación de algunos tipos de animación SVG 


Rectángulo base del ejemplo 


r 


a 
<?xml version=”1.0” encoding=”UTE—-8” standalone 
="no0”?> Imagen base: 
<svg xmlns=”http: //www.w3.org/2000/svg” width 
=”300” height=”200” version=”1.1”> 
<rect x=”40” y=”40” width=”100” height=”40” E 
stroke=”black” stroke—width=”5” fill=” 
cyan”> 
</rect> 
</svg> 
Ne zen 
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Desplazamiento horizontal 


Imagen base: 


E] 


Imagen final: 


[| 


Desplazamiento vertical 


Imagen base: 


E 


Imagen final: 


ES 
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Desplazamiento a lo largo de una trayectoria 


Imagen base: 


ES 


Imagen final: 


Y 


Cambio de la altura 


Imagen base: 


E 


Imagen final: 


[] 
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Cambio del ancho 


Imagen base: 


E 


Imagen final: 


E 


Rotación alrededor del punto (0, 0) 


Imagen base: 


E 


Imagen final: 


Y 
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Rotación alrededor de un punto arbitrario 


Imagen base: 


Imagen final: 


Y 
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Cambio de color 


Imagen base: 


Imagen final: 


Texto base del ejemplo 


Imagen base: 


0.0 
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Cambio de texto 


Imagen base: 


0.0 


Imagen final: 


0.2 


Ejemplo 7.6: Animación 2D. 


La figura 7.9 muestra el gráfico diseñado para la animación del ejemplo. Se 
trata de dos sensores diferentes: 
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Velocidad angular (rad/s) 
6 2 lo 
Ñ Ó 
a So 


Potencia mecánica (W) 


Figura 7.9 Gráfico SVG para la animación del ejemplo 


= Un sensor de aguja (parte superior del gráfico) para mostrar el valor de 
la velocidad angular. Se trata de una línea con una marca final, que rota 
alrededor del punto 150,100. El ángulo de rotación se controla con el 
resultado de la simulación para la variable J.w, que corresponde a la 
velocidad angular. 


= Un sensor de barra (parte inferior del gráfico) para mostrar el valor de la 
potencia mecánica. Se trata de un rectángulo en una posición fija, cuyo 
ancho se controla con el resultado de la simulación para la variable Pj, 
que corresponde a la potencia mecánica. 


La aguja del sensor (en rojo) está en las coordenadas (0, 0). 


7.2.7 Experimentos sugeridos 


Una misma planta de experimentación puede permitir el desarrollo de mu- 
chos experimentos diferentes. El modelador puede sugerir algunos de ellos. 
En la construcción de las sugerencias es conveniente tener en cuenta las 
recomendaciones que se formulan en [Dav08], algunas de las cuales se han 
condensado en la sección 5.4. Especial atención debe darse al nivel de au- 
tonomía necesario para realizar el experimento según el tipo de actividad 
(véase tabla 5.4). 
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Tabla 7.5 Posibles usos y consideraciones de diseño para diferentes aproximaciones a las actividades de 
laboratorio (tomado de [Dav08]) 


Demostración 
= Mostrar algunas características de una pieza de un equipo y cómo funciona. 
= Mostrar un concepto particular de una teoría. 


= Utilizar una estrategia de mostrar y contar pero incluyendo mayor interacción con los es- 
tudiantes al formular preguntas que activen la reflexión. 


Ejercicio 
= Utilizar una técnica o habilidad de forma precisa. 
= Enfocarse en el uso adecuado de un procedimiento, más que en la investigación. 


= Los estudiantes deben conocer el propósito del trabajo práctico y su importancia potencial 
en el desempeño profesional. 


= Este tipo de actividad puede mejorarse mediante un contexto motivacional, tal como per- 
mitirles a los estudiantes la selección del equipo adecuado. 


Investigación estructurada 


= Fomentar una aproximación más profunda al aprendizaje de laboratorio, impulsando a los 
estudiantes a tomar iniciativas personales tales como planificar y diseñar el experimento, 
elegir las variables, seleccionar los métodos y materiales, etc. 


= Alos estudiantes se les presenta un problema o una serie de preguntas de investigación que 
pueden basarse en la vida real, junto con sugerencias sobre los materiales de investigación 
y el tipo de equipo y material que deben elegir. 


= El rango de posibles resultados genera soluciones individuales, de tal manera que se redu- 
cen las posibilidades de plagio. 


Investigación abierta 


= Se tienen en cuenta las consideraciones de la investigación estructurada, pero con un nú- 
mero mayor de decisiones y decisiones de diseño a cargo del estudiante. 


Proyecto 


= Se tienen en cuenta las consideraciones de la investigación abierta, pero con una mayor 
cantidad de piezas de trabajo que simulen la investigación y desarrollo en el mundo real. 


Para UNVirtualLab un experimento sugerido es un texto breve que sirve 
como guía al experimentador sobre posibles usos de la planta. En [Dav08] 
se lista un conjunto de posibles usos que cada tipo de actividad puede te- 
ner, desde la perspectiva del aprendizaje. La tabla 7.5 reproduce ese listado. 
UN VirtualLab permite desarrollar en línea actividades de los primeros tres ti- 
pos, mientras que para los últimos dos tipos el experimentador debe descargar 
el código fuente y manipularlo en el ambiente de OpenModelica. 
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Ejemplo 7.7: Experimentos sugeridos. 


La tabla 7.6 muestra seis experimentos sugeridos que se han preparado para 
el ejemplo, con los que se cubren todos los tipos de actividad a que se refiere 
la tabla 5.4. Estos experimentos buscan facilitar el aprendizaje de los objetivos 
formulados en la sección 7.2.1. 


7.2.8 Documentación 


La documentación asociada a cada planta experimental debe elaborarse en 
formato PDF. La ventana en la que se presenta tiene un tamaño que depende 
del diseño del tema seleccionado”. El formato en el que se despliega el archivo 
depende del módulo de visualización que tenga el navegador del usuario para 
archivos PDE. 

El contenido de la documentación es muy importante como soporte al 
aprendizaje. Se sugiere que la documentación incluya, al menos, una explica- 
ción de los siguientes aspectos: 


a. El modelo: explicación de los aspectos teóricos asociados a la planta de 
experimentación, y descripción de los fenómenos a simular y las leyes que 
los gobiernan. En general, este aspecto se refiere a todas aquellas explica- 
ciones que permitan ingresar al ciclo de aprendizaje de Kolb a través de la 
conceptualización abstracta (véase figura 6.1). 


b. Plantas de experimentación: descripción de la planta de experimentación 
que ilustre la función de cada uno de los instrumentos disponibles, tanto 
los de control como los de visualización. Esta explicación debe ayudar a 
ingresar al ciclo de aprendizaje de Kolb a través de la experiencia concreta 
o de la expermientación activa (véase figura 6.1). 


c. Experimentos sugeridos: explicación de los expermentos sugeridos para 
realizar con la planta. Esta explicación busca ayudar a ingresar al ciclo de 
aprendizaje de Kolb a través de la observación reflexiva (véase figura 6.1). 


7En el tema unvlbasic el tamaño de la ventana es de 680 x 260 pixeles. 
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Tabla 7.6 Experimentos sugeridos para el ejemplo de la sección 7.2 


Nombre Tipo Encabezado Descripción 

Segunda ley de Demostración | Verifique el cumplimiento | Analice el tipo de relación 

Newton de la de la segunda ley de New- | que hay entre el par me- 

rotación ton de la rotación. cánico y la aceleración an- 

gular. Pruebe para distin- 
tos valores del momento 
de inercia. 

Suma de potencias Demostración | Verifique que la suma total | Utilice la tabla de datos 
de potencias en el sistema | para verificar en una hoja 
es nula. electrónica cuánto suman 

las potencias en los dife- 
rentes elementos del siste- 
ma. Repita el ejercicio para 
diferentes condiciones de 
simulación. 

Tiempo de asenta- | Ejercicio ¿Cuál es el tiempo de asen- | Obtenga el tiempo en el 

miento de la veloci- tamiento de la velocidad | que la velocidad angular 

dad angular angular? ¿Qué relación tie- | llega al 95 % de su valor fi- 
ne con el momento de | nal. Realice el cálculo para 
inercia, con la resistencia | diferentes condiciones de 
eléctrica y conlainductan- | momento de inercia, resis- 
cia eléctrica? tencia eléctrica einductan- 
cia eléctrica. 

Velocidad angular Investigación | ¿Qué relación hay entre el | Encuentre el efecto que tie- 

estacionaria estructurada | valor estacionario dela ve- | ne el cambio en la ten- 
locidad angular y la ten- | sión de alimentación so- 
sión de alimentación? bre la velocidad angular 

estacionaria. Utilice el mo- 
delo matemático para de- 
ducir una expresión sobre 
esta relación y contrástela 
con el comportamiento del 
modelo. 

Efectos de la carga | Investigación | ¿Cómo incide la carga me- | Explore la relación entre la 

mecánica en el abierta cánica sobre las variables | carga mecánica y las di- 

circuito eléctrico eléctricas del motor? ferentes variables de tipo 

eléctrico que intervienen 
en el motor. 

Simulación de Proyecto Aplique el modelo para el | Obtenga un modelo de 

dispositivos diseño de un elemento ro- | software para simular 
tacional activado por un | el comportamiento de 
motor DC. un dispositivo real que 

emplee un motor DC. 


La implementación: descripción de la forma en que fue implementado el 
modelo teórico en lenguaje Modelica para ser simulado. Esta descripción 
debe contener los detalles que permitan modificar o complementar la plan- 
ta en el ambiente OpenModelica. Se busca que esta explicación ayude a in- 
gresar al ciclo de aprendizaje de Kolb a través de la experimentación activa 
(véase figura 6.1). 
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Ejemplo 7.8: Documentación. 


La documentación asociada al modelo se presenta en el capítulo 8. Los aspec- 
tos teóricos que se han incluído son los siguientes: 


= Principios físicos: una explicación de las leyes físicas que explican el com- 
portamiento del motor DC. 


= Forma constructiva y principios de operación: una descripción de una de 
las formas constructivas del motor más comunes, y una explicación 
de cómo gracias a ese diseño se logra transformar la energía eléctrica en 
energía mecánica rotacional. 


= Modelo matemático: a partir de las leyes físicas y teniendo en cuenta 
la forma constructiva se deriva el modelo matemático que describe el 
comportamiento del motor DC. 


La documentación de las plantas de experimentación, los experimentos 
sugeridos y la implementación se realiza utilizando los scripts que se presentan 
en la sección 7.2.9. 


7.2.9 Ayudas para la documentación 


El script latex/esqueleto.php es una herramienta auxiliar para la tarea 
de documentación (DC). El script lee desde la base de datos la información de 
una o más plantas experimentales y genera varios archivos en formato BTÉX 
con dicha documentación. Específicamente, el script construye: 


DC 1. Una carpeta de nombre definido por el usuario, en la que se incluirán 
los demás archivos y subcarpetas creados. 


DC 2. Un archivo de nombre definido por el usuario, con el código KTÍX del 
archivo principal y que enlaza los demás archivos. En especial, enlaza 
el archivo latex/preambulo.tex que contiene las definiciones nece- 
sarias para la compilación del documento. 


DC 3. Varios archivos en formato XTÉxX: 


= archivos.tex: contiene información relativa al código fuente de 
la implementación en lenguaje Modelica. 
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= experimentos.tex: contiene información relativa a las plantas 
de experimentación. 


= implementación.tex: archivo vacío. Se espera que el usuario re- 
dacte en este archivo la explicación sobre cómo se realizó la im- 
plementación de la planta de experimentación. 


= modelo.tex: archivo vacío. Se espera que el usuario redacte en 
este archivo la explicación sobre los fundamentos teóricos del mo- 
delo de las plantas de experimentación. 


= presentacion.tex: archivo vacío. Se espera que el usuario re- 
dacte en este archivo una breve presentación de las plantas de ex- 
perimentación. 


= referencias.tex: archivo vacío. Se espera que el usuario incluya 
en este archivo las instrucciones BTÉX relacionadas con las citas 
bibliográficas. 


= resumen.tex: contiene la descripción de la planta de 
experimentación. 


Una colección de archivos BIfX de nombre exp/expXXX.tex con in- 
formación general de cada planta de experimentación, y el listado de 
experimentos sugeridos asociados. 


Una colección de archivos gráficos en formato ps de nombre expFig/ 
expXXX .ps con imágenes de las figuras y animaciones de cada planta 
de experimentación. 


Una colección de tablas en formato BTFX de nombre expTab/expTab 
XXX .tex con información de todos los parámetros, gráficas, animacio- 
nes y tablas de salida de datos de cada planta de experimentación. 


Una colección de archivos BTÉX de nombre expTex/expXXX.tex. Se 
espera que el usuario redacte en estos archivos la información especifi- 
ca que desee incorporar a la documentación de cada planta de 
experimentación. 


Una carpeta vacía de nombre figuras. Se espera que el usuario adi- 
cione en esta carpeta las figuras que se incluyan en la documentación. 
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Ejemplo 7.9: Ayuda para la generación de documentación. 


La documentación asociada al modelo, que se presenta en el capítulo 8 (al 
igual que toda la documentación contenida en la parte III) ha sido elaborada 
a partir de los archivos generados por por el script latex/esqueleto. php. 
Específicamente las tablas 8.1, 8.2, 8.3, 8.4 y 8.5 así como el listado de experi- 
mentos sugeridos de la sección 8.2 han sido construidos automáticamente a 
partir de la información administrada por UNVirtualLab. 


7.3 MANUAL DEL EXPERIMENTADOR 


El manual del experimentador de UNVirtualLab se ha elaborado como una 
colección de preguntas frecuentes, que se consignan en la tabla 7.7. En la im- 
plementación en línea del manual cada pregunta se acompaña de un breve 
video que muestra cada procedimiento. En este documento los videos se han 
sustituido por las imágenes de la tabla 7.7. 


Tabla 7.7 Listado de preguntas frecuentes relativas a UN VirtualLab 


Pregunta Respuesta Imagen 


VirtualLab U.N. Calentamiento de un cable aéreo desnudo 


El menú de selección 
muestra el listado de plan- 
tas de experimentación 


1. ¿Cómo disponibles. Las plantas 
selecciono una están agrupadas en sec- 
planta de expe- | ciones. Para seleccionar 
A 2 “Temperatura de conductor y de aire Flujo de calor 
rimentación? una planta, navegue en : z 


el menú a lo largo de las | fem, 
secciones y haga clic sobre | [5 
la planta deseada. E 


101) ve (nou), 
Ta: (laCollus) vs (ou) 


Comiente Flecha 


46 96.*.+*+..1u07 
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Pregunta Respuesta Imagen 
VirtualLab U.N. Motor eléctrico DC de imanes permanentes 
Su : 
NES 
O E 
A 
2. ¿Cómo Haga clic sobre el botón 
lanzo una “Simular” que está en el re- 
simulación? cuadro de los controles Variables eléctricas Variables mecánicas 


$ $... o o 


Larva 
Mes is) 
tom (Y) ve (e (am) ve (e) 


(rad) vs la) 
a: (radis2)vs (5) 


Paraceleración 


3. ¿Cómo mo- 
difico las condi- 
ciones de la 
simulación? 


Utilice los controles dispo- 
nibles para ello. Tiene tres 
alternativas: 1) escribir el 
valor deseado; 2) utilizar 
las flechas para aumentar 
o disminuir el valor; y 3) 
utilizar el botón deslizante 
para ajustar el valor. 

El botón “Restaurar” le 
permite recuperar los va- 
lores por defecto de todos 
los parámetros. 


de Molor DC 


VirtualLab U.N. 


Motor eléctrico DC de imanes permanentes 


MoraR ELÉCTRICO DE CORRIENTE CONTINIA E IMANES PERMANENTES 


"ear 6, Duato 


MR ay ne 
"sn crgamecóica an ficción. El mado permi clear ls principales variaba 
clics y rámicas, al somo os pencas en distilos eementes del idem 


ao 


Variables eléctricas Variables mecánicas 


+ 


$ $... 


NO we trad) 
Msi) 
tom (Y) ve 2 Tm ve (e) 


(e) 
a: (radis2)vs (5) 


Polencias Paraceleración 


4. ¿Cómo des- 
cargo los resul- 
tados de la 
simulación? 


Haga clic sobre el botón 
“Descargar” que está so- 
bre la tabla de resultados. 
El archivo de descarga es- 
tá en formato CSV, separa- 
do por tabulador. El sepa- 
rador decimal empleado es 
la coma. 


Mv) 3 
rem WV)yS (9) Tm) (e) 
Paraceleración 


Polencias 


er 
EIN 
Er 
ESOS! 


T ve ala (Num) vs (rad/s2) 


Velociao angular rad) 


Er 


pas 


CORE a e] 


020 0136) 1256 [rasta 130500: 


pa 


[e [amo jerss osas 


moron aaa aófiaz oo] 132200] 1: 


1280 


eeeeadane| 70) ac 


vas] 


A E 
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Pregunta Respuesta Imagen 


localhost, 


SR 
A 
, Haga clic sobre el logo de o AA | 
5. ¿Dónde . o. 
ayuda. Se desplegará una E 
encuentro los A Ñ [enssatogunetes: co 
: ventana que contiene in- pe 
experimentos 04 Cane nen Jete 
: formación sobre la planta | == po eta meno regios 
sugeridos para : Ei Sens eternos 
Ñ experimental, entre la que Ea Dcameración 
realizar con la . e E eones 
lanta? se encuentra el listado de a [Eee 
anta? A : Et 
P experimentos sugeridos. 
Haga clic sobre el logo de 
, 
ayuda. Se desplegará una -.. 
ventana que contiene in- inrmacó dl melo 
e a 
formación sobre la planta A AN 
experimental. En la línea E >= 
6. ¿Cómo marcada como “Archivos” 


descargo la 


encontrará el enlace a la 


Enlaces para incrustar 


Frans =p /ocaho mania 
Varitod ptr 7mocald=t"wistr=01) ight=400> 
[efames 


[Same "np Tocatas 

[Documentación [o=.oho?modelc=" witr=340 neirt=800> 
[<emo» 

AS 

[escamenenon par 


documentación? “Documentación” que está 
en formato PDF. También 
puede utilizar las opciones 3 de Negre mai q 
de descarga del visualiza- — 
dor de PDF de su navega- 
dor, si este las tiene. 


Haga clic sobre el logo de 

localhost, el 
ayuda. Se desplegará una perros 
ventana que contiene in- sc doo orar pic as dr 
formación sobre la plan- 
ta experimental. En la lí- 
nea marcada como “Ar- 
chivos” encontrará el enla- 
ce a los “Archivos Modeli- 
ca”, que aparecen compri- a y A 
midos en un único archivo ES 
en formato tar. gz. 


[ara del mae 


[nosetadoras. 


7. ¿Cómo des- 
cargo el código 
fuente de la 
simulación? 


[ans =p /ocaho mania 
[toselo Varibod ptr 7mocalá=t"wistr=01) eight=400> 


T 
li 


Y 


Il 
¿ 


00 se Tecalosiandao 

[Documentación [ocpho?modelc=1 witn=340 heirt=400> 
[oemo» 

AS 

[eszamenenon par 


"1 


..o..oo 


E 


T 
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Pregunta 


Respuesta 


Imagen 


8. ¿Cómo in- 
serto la planta 
de experimen- 
tación en un 
documento 


Haga clic sobre el logo de 
ayuda. Se desplegará una 
ventana que contiene in- 
formación sobre la plan- 
ta experimental. En la lí- 
nea marcada como “Mo- 
delo”, bajo la marca “Enla- 
ces para incrustar” encon- 
trará el código en lengua- 
je HTML que necesita para 


E localhost/unv 


about php?modelid=1 


nirmación del modelo 
[eme cemoce — [porro 
[aer ecanes de comente sanirua y campo 
[peccrpción dalmodelo [perranonte acopiedo  4na carga masent sin 
[reci 
[ea da modo 
[orar Doa Vea 
proeacós [eatsatesgureleds co) 
== [áravos Nodoico 


tostada 


] A AN 
SCORM o incrustar en su documento la la 
el experimento. Este códi- curodnirio de segona er 
HTML: : best cr a er 
go genera un frameinterno aa A 
que contiene todos los ins- 
trumentos de la planta, es 
decir, que contiene tanto 
los controles como los vi- 
sualizadores. 
Haga clic sobre el logo de 
ayuda. Se desplegará una 
ventana que contiene in- 
formación sobre la planta 
ED localhost, be p?modelid=1 
experimental. En la línea A 
E marcada como “Documen- | ¡amara o AN 
esERoO tación”, bajo la marca “En- | | > — 
inserto la docu- 200) A 


mentación en 
un documento 


laces para incrustar” en- 
contrará el código en len- 
guaje HTML que necesita 


"Enlaces para inerurar 


ramo np ocanostunia 
[embed ocrmoceiá=1" wtsl=990 echt=+00> 
IONES 


SCORM a 

o HTML? para incrustar en su docu- - 
mento la documentación era a A E 
de la planta. También pue- Hr = 
de emplear el enlace de 
la línea “Pdf” para enla- 
zar directamente el archi- 
vo pdf correspondiente. 

10. ¿Cómo 

incorporo más Esta opción sólo está dis- 

controles, ponible para el adminis- 

gráficas o trador del sitio. 

animaciones? 
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Parte III 


Plantas experimentales, modelos 
y experimentos 


MOTOR ELÉCTRICO DE CORRIENTE 
CONTINUA E IMANES PERMANENTES 


Modelo de un motor eléctrico de corriente continua y campo per- 
manente acoplado a una carga mecánica sin fricción. El modelo 
permite calcular las principales variables eléctricas y mecánicas, 
así como las potencias en distintos elementos del sistema. 


Se presenta la implementación muy conoci- 
da del modelo de un motor eléctrico de co- 
rriente continua de imanes permanentes. Es- 
tá basada en implementaciones populares que 
se emplean en varios tutoriales de Modelica y 
OpenModelica. Es un ejemplo típico de mo- 
delamiento de un sistema multidominio, pues 
incluye elementos del dominio eléctrico y me- 
cánico. El modelo corresponde a un sistema li- 


Figura 8.1 Rotor de un motor DC de 
neal invariante en el tiempo de segundo orden, imanes permanentes! 


que no incluye fenómenos de fricción mecáni- 
ca ni pérdidas magnéticas. 


Tomada de [link:12] con licencia de Creative Commons. 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


El modelo se ha seleccionado por su simplicidad como el sistema mínimo 
de ejemplo que acompaña la instalación de UNVirtualLab. 


8.1 EL MODELO 
8.1.1 Principios físicos 


Los motores eléctricos aprovechan el fenómeno físico conocido como fuerza 
de Lorentz. Este puede enunciarse de la siguiente forma (véase, por ejemplo, 
[Cha05], pág. 33): 


Una carga q que se mueve con velocidad v en presencia de un cam- 
po magnético cuya densidad de flujo magnético es B, experimenta 
una fuerza f causada por dicho campo, calculada como?: 


f=q(vxB) (8.1) 


Si, en lugar de una carga eléctrica en movimiento, se analiza una corriente 
eléctrica I que circula a lo largo de un hilo de longitud L (y elemento diferen- 
cial dl), la ecuación 8.1 se convierte en: 


f= fa -dl x B) (8.2) 


Otro de los fenómenos involucrados en el funcionamiento del motor eléc- 
trico es la inducción electromagnética. Este fenómeno se explica por la ley de 
Faraday, que puede enunciarse como (véase, por ejemplo, [Cha05], pág. 35): 


La variación de flujo magnético al interior de un circuito cerrado 
induce una fuerza electromotriz igual al negativo de la rata de cam- 
bio del flujo magnético. En el caso de una espira atravesada por un 
flujo magnético 1, la tensión inducida v, se calcula como: 


Ve = =— (8.3) 


En particular, si un hilo conductor de longitud L (y vector de dirección 1) 
que forma parte de un circuito cerrado que atraviesa un campo magnético de 
densidad de flujo B a una velocidad v, entonces dicho hilo experimenta entre 
sus extremos una diferencia de tensión v. 


Ve =(vxB)-1 (8.4) 


Las expresiones en las ecuaciones 8.1 y 8.2 son vectoriales; el operador x representa el producto 
vectorial. 
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8.1.2 Forma constructiva y principio de operación 


La figura 8.2 muestra el esquema de una forma constructiva posible para un 
motor DC de imanes permanentes que tiene las siguientes características 
principales”: 


Figura 8.2 Esquema de una forma constructiva de un motor DC de imanes permanentes 


= Existe un elemento fijo denominado estator. Adosado al estator se en- 
cuentra un imán que provee un campo magnético de densidad B, cuya 
magnitud es B. 


= Existe un elemento móvil denominado rotor. El rotor puede girar alre- 
dedor de un eje x — 2”. 


= El rotor afecta las líneas de campo magnético, tal como se observa en la 
figura 8.3: se destaca en la figura 8.3(c) que las líneas de campo magnéti- 
co son prácticamente radiales en el entrehierro, es decir perpendiculares 
al eje de rotación del motor. 


= Adosado al rotor hay un arrollamiento que consta de N espiras. El largo 
de cada espira es L y el ancho es 7; por tanto, tiene un área A = 2rL. La 
figura 8.4 ilustra la geometría de una espira. 


= A través del arrollamiento circula la corriente I, cuya magnitud es ¿. 


= La corriente ingresa (y sale) del arrollamiento a través de un juego de es- 
cobillas y colector. Este elemento realiza una conmutación, de tal forma 
que el sentido de la corriente por el lado cercano a cada polo no se altera 
aunque la espira gire. 


3Una descripción más extensa puede encontrarse en el capítulo 9 de [Cha05]. 
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(a) Sin rotor 


(c) En el entrehierro 


Figura 8.3 Líneas de campo magnético en un motor DC de imanes permanentes 


La corriente que circula por el lado derecho de la espira interactúa con el 
campo magnético, produciendo una fuerza de Lorentz hacia arriba de valor 
f (véase figura 8.5). Al pasar por el lado izquierdo se produce otra fuerza de 
Lorentz del mismo valor f, pero hacia abajo. El valor de f se puede calcular 


como: 
f=iLB (8.5) 
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Corriente 
entrando al 


N” S 


Corriente 
saliendo del 


(a) Una espira. Vista de frente 


Lg! 
| 


l 
IZ 


(b) Una espira. Vista de planta 


Figura 8.4 Geometría de una espira 
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Figura 8.5 Fuerzas y torques en una espira 


Cada una de esas fuerzas genera un par rotacional 7 = fr en el sentido 
antihorario. El par total recibido por el arrollamiento es 7”: 


T=2N7T 

T =2NTriLB 

T = NABi sii 
T=Ki 


en donde se ha definido K = NAB, que resulta ser una constante que de- 
pende de aspectos constructivos del motor. La ecuación 8.6 muestra que el 
par rotacional es directamente proporcional a la corriente que circula en el 
arrollamiento. 

El par generado produce una aceleración angular a en el rotor. Si el mo- 
mento de inercia total del rotor y su carga mecánica acoplada es J, la segunda 
ley de Newton de la rotación establece que 


T=Ja (8.7) 


Por otra parte, en cada uno de los dos segmentos de las espiras que son 
paralelos al eje de rotación se induce una tensión V, (véase figura 8.6). La ten- 
sión en cada espira será 2V., y la tensión en el arrollamiento completo será la 
fuerza electromotriz fem = 2N V.. Si el rotor gira a una velocidad angular w 
la magnitud de la velocidad tangencial será v = wr. En esas condiciones: 
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fem =2NV. 
fem = -—2NvBL 
fem = —2NurLB (8.8) 
fem= —NABuw 
fem=-—Kuw 
Xx 
+ = 
B / 
SS pS 
T 


Figura 8.6 Fuerza electromotriz inducida en una espira 


8.1.3 Modelo matemático 
8.1.3.1 Ecuación diferencial 


La figura 8.7 muestra el diagrama del sistema modelado. Una fuente de tensión 
de valor vs(t) suministra la energía al sistema. El circuito eléctrico del motor 
se ha modelado como un arreglo en serie de tres elementos: 


= Un resistor lineal cuya resistencia es R. 


= Un inductor lineal cuya inductancia es L. 
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= Una fuerza electromotriz fem de constante K. La tensión en la fem se 
representa por Ven. 


R L 
HH O CORRA 
a 
7” 6 
A ¿(t) , 
J 
Us(t) == 7 


Figura 8.7 Diagrama de un motor DC de imanes permanentes acoplado a una carga mecánica 


Utilizando la ley de tensiones de Kirchhoff, y haciendo uso de la ecua- 
ción 8.5 se puede escribir la ecuación del circuito eléctrico: 


di(t 
Eo pra A 
dile) (8.9) 
vs(t) = Ri(t) + L 7 + Kw(t) 
A partir de las ecuaciones 8.6 y 8.7 se puede escribir: 
Ki(t) = Ja(t) 
dw(t) 
Ki(t) = Esa (8.10) 
J dw(t) 
1)= q 
Lo que permite reescribir la ecuación 8.9 como 
RJdw(t)  LJdw(t) 
== Ku(t 
LJ d? d 
ie Jdéw(t) RJ dw(t) Kw(t) 


—K de K dt 
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8.1.3.2 Función de transferencia 


La ecuación 8.11 corresponde a un sistema lineal de segundo orden. Para rea- 
lizar un análisis en el dominio de Laplace, podemos tomar la velocidad angu- 
lar w(t) como la salida del sistema (véase, por ejemplo, [Dua05], pág.47). En 
esas condiciones, la función de transferencia resulta ser F(s) = ya y puede 
obtenerse de la siguiente forma: 


ae W(s)8 y aw (8)s +KW(s) 


Vals) = ES + de + K) W(s) 


K K 

is LJs? e EN 

K 
W(s) K 
Vals) LJ +RIs PK? au 
W(s) — K 
Vals) LJs2+RJs+K? 
FPís) = K 

eS LJs? + RJs + K? 
K/LJ 


LOS AD 
8.1.3.3 Estabilidad 


Los polos de la función de transferencia obtenida en la ecuación 8.12 son 


OR, [RR ar? 
MASON 


(8.13) 


De la ecuación 8.13 se desprende que el sistema no puede tener polos con 
parte real positiva, y por tanto su comportamiento es estable (véase, por ejem- 
plo, [Dua05], pág.71). 


8.1.3.4 Estado estacionario 


A partir de la ecuación 8.12 es posible conocer la velocidad angular de estado 
estacionario (wee) ante una entrada de tensión escalón de altura V (véase, por 
ejemplo, [Dua05], pág. 93): 
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Wee = lím s—F(s) 
s>0 


Ss 
nl K/LJ 
ee = UM S 
mee 20% s s2+ R/Ls + K?/LJ 
K/LJ 
ee = V 8.14 
de 02+R/LO+K?/LJ si 
K/LJ 
Wwe = VÍ] 
E 
Wee = K 


8.1.3.5 Comportamiento transitorio 


De la ecuación 8.13 se desprende que el comportamiento transitorio del siste- 
ma puede ser subamortiguado, sobreamortiguado o en amortiguamiento crí- 
tico (véase, por ejemplo, [Dua05], pág.73). La condición de subamortigua- 
miento resulta ser: 


4kK?_ R? 
LJ TI? 

4K?  R? 
dá L 
a a 


(8.15) 


8.2 PLANTAS DE EXPERIMENTACIÓN Y EXPERIMENTOS SUGERIDOS 


Planta de experimentación 1: Motor eléctrico DC de imanes 
permanentes. 


Presentación: Esta planta implementa el modelo de un motor eléctrico de 


corriente contínua y campo permanente acoplado a una carga mecánica sin 
fricción. La planta permite modificar los parámetros eléctricos y mecánicos 
principales, y visualizar el comportamiento de las variables mecánicas, eléc- 
tricas y las potencias en los diferentes elementos del sistema. 
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Instrumentación”: el modelo cuenta con 6 parámetros ajustables organiza- 
dos en 3 grupos de controles (véase tabla 8.1). Como resultado del experi- 
mento, el programa despliega: 


= 11 curvas organizadas en 4 gráficos (véase tabla 8.2). 
= 1 animación en 2D (véase tabla 8.3). 


= Una tabla de datos del comportamiento de 11 variables (véase 
tabla 8.4). 


Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 1.1: Segunda ley de Newton de la rotación. 


Verifique el cumplimiento de la segunda Ley de Newton de la Rotación. 
Analice qué tipo de relación hay entre el par mecánico y la aceleración 
angular. Pruebe para distintos valores del momento de inercia. 


Experimento 1.2: Tiempo de asentamiento de la velocidad angular. 


¿Cuál es el tiempo de asentamiento de la velocidad angular? ¿Qué relación 
tiene con el momento de inercia, con la resistencia eléctrica, con la induc- 
tancia eléctrica? Obtenga el tiempo en el que la velocidad angular llega 
al 95% de su valor final. Realice el cálculo para diferentes condiciones de 
momento de inercia, resistencia eléctrica e inductancia eléctrica. 


Experimento 1.3: Velocidad angular estacionaria. 


¿Qué relación hay entre el valor estacionario de la velocidad angular y la 
tensión de alimentación? Encuentre el efecto que tiene el cambio en la 
tensión de alimentación sobre la velocidad angular estacionaria. Utilice 
el modelo matemático para deducir una expresión sobre esta relación y 
contrástela con el comportamiento del modelo. 
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Experimento 1.4: Efectos de la carga mecánica en el circuito eléctrico. 


¿Cómo incide la carga mecánica sobre las variables eléctricas del motor? 
Explore la relación entre la carga mecánica y las diferentes variables de tipo 
eléctrico que intervienen en el motor. 


Experimento 1.5: Simulación de dispositivos. 


Aplique el modelo para el diseño de un elemento rotacional activado por 
un motorDC. Obtenga un modelo de software para simular el comporta- 
miento de un dispositivo real que emplee un motor DC. 


Experimento 1.6: Suma de potencias. 


Verifique que la suma total de potencias en el sistema es nula. Utilice la 
tabla de datos para verificar en una hoja electrónica cuánto suman las po- 
tencias en los diferentes elementos del sistema. Repita el ejercicio para di- 
ferentes condiciones de simulación. 


Tabla 8.1 Parámetros del experimento 1, “Motor eléctrico DC de imanes permanentes”? 


Título: Motor DC 
Descripción: Motor eléctrico de corriente contínua y campo permanente acoplado a 
una carga mecánica sin fricción. 
Implementación Oscar Germán Duarte Velasco 
Créditos e-mail ogduartevOunal.edu.co 
Parámetros 
Grupo nombre Modelica nombre descripción 
Parámetros mecánicos J.J Inercia Momento de inercia de la carga 
mecánica (kg.m2) 


4La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 
hay datos tanto en español como en inglés. 
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R.R Resistencia Resistencia eléctrica del motor 
(Ohm) 
Parámetros eléctricos L.L Inductancia Inductancia del motor (H) 
emf.k Constante de conversión | Constante de conversión electro- 
magnética (N.m/A) 
step.height Alimentación Tensión de alimentación (V) 
Parámetros de simulación | stopT'ime Tiempo de parada Tiempo de parada de la 
simulación 


Tabla 8.2 Figuras del experimento 1, “Motor eléctrico DC de imanes permanentes” 


r - a 
Variables eléctricas 
Variables eléctricas 
Variables eléctricas del modelo 
Curva Descripción T y 
Variables eléctricas A y 
I t R. 
del modelo ne A 
vl Variables eléctricas time Lv 
del modelo 
L: (A) VS (8) Variables eléctricas 4 
VI : (V) vs (s) fem del modelo He suby 
fem : (V) vs (s) 
r : a y 
Variables mecánicas - _— 
Variables mecánicas 
Variables mecánicas del modelo 
Curva Descripción z Y 
Variables mecánicas del , 
w time Jw 
modelo 
Variables mecánicas del 
a time alfa 
modelo 
y . 7 J. flan- 
w: (rad)s) vs (S) 7 Variables mecánicas del Hi eb 
a: (rad/s2) vs (s) modelo E A 
T : (Nam) vs (s) ia 
A ; . 
Potencias Potencias 
Potencias en distintos elementos del sistema 
5 Curva Descripción z 7) 
Potencias en distintos 
E EE elementos del sistema He ESv 
Potencias en distintos E 
Pm ; time Pj 
E elementos del sistema 
] n Potencias en distintos . 
FT: (vv) VS (5) Pr 1 del si time Pr 
Pm: (W) vs (s) elementos del sistema 
Pr: (W) vs (s) Pl Potencias en distintos time Pl 
PI : (W) vs (s) elementos del sistema 


5La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 
hay datos tanto en español como en inglés. 
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fr 


Par-aceleración 


Par-aceleración 


Curva Descripción o 


T vs alfa alfa 


El 
J. flange b. 
tau 


T vs alfa : (N.m) vs (rad/s2) 
_ A 


Tabla 8.3 Animaciones del experimento 1, “Motor eléctrico DC de imanes permanentes” 


Velocidad angular (rad/s) 


Sensores 
Animación con sensores de variables del modelo 
Efectos 
Nombre Descripción Tipo Variable 
Abrió Sensor de velocidad single Jw 
Potencia mecánica (W) gu) angular 8 
Pm(W) E Pame 


0 40 $0 120 160 200 


Tabla 8.4 Variables en la tabla de resultados del experimento 1, “Motor eléctrico DC de imanes 


permanentes” 
Variable Descripción Unidades 
time time Ss 
Ri Current flowing from pin p to pin n A 
L.v Voltage drop between the two pins (= p.v - n.v) V 
emf.v Voltage drop between the two pins V 
Jaw Absolute angular velocity of component (= der(phi)) rad/s 
alfa rad/s2 
J.flange_b.tau Cut torque in the flange N.m 
Psv W 
Pj w 
Pr W 
Pl wW 


8.3 LA IMPLEMENTACIÓN 


La implementación del modelo se basa en la propuesta en [FPA*13a] (pág. 
18). A este modelo se la han adicionado las variables de aceleración angular y 
la potencia transformada en varios elementos del sistema. 
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El modelo utiliza una única clase DCmotor, que se construye interconec- 
tando elementos disponibles en la Modelica Standard Library (MSL). El ar- 
chivo DCmotor.mo muestra el código fuente de la implementación. 

No se ha hecho uso de los elementos del paquete Electrical. Machines de 
la Modelica Standard Library, pese a que allí se incluye una implementación 
más detallada de las máquinas de corriente contínua en general. Esta decisión 
se ha tomado para que el ejemplo resulte más ilustrativo en relación con el uso 
de UN VirtualLab. 


8.3.1 Listado de archivos 


La tabla 8.5 muestra el listado de los archivos fuente de la implementación del 
modelo. 


Tabla 8.5 Archivos del modelo 


Número Archivo 
8.1 DCmotor.mo 


Archivo 8.1 DCmotor.mo 


model DCmotor 
Modelica. Electrical. Analog. Basic. Resistor R(R = 1); 
Modelica. Electrical.Analog. Basic.Inductor L(L = 0.01); 
Modelica. Electrical. Analog. Basic .EMF emf(k = 1); 
Modelica. Electrical. Analog. Basic .Ground g; 
Modelica.Blocks.Sources.Step step(height = 12); 
Modelica. Mechanics. Rotational. Components. Inertia J(J] = 1); 
Modelica. Electrical. Analog. Sources.SignalVoltage SV; 
Modelica.Slunits.Power Psv ”Potencia en la fuente”; 
Modelica.Slunits.Power Pr ”Potencia en la resistencia”; 
Modelica.Slunits.Power Pl ”Potencia en la inductancia”; 
Modelica. Slunits.Power Pj ”Potencia en la carga mecánica”; 
Modelica.Slunits.Power PT ”Potencia total”; 
Modelica. Slunits. AngularAcceleration alfa ”Aceleración angular”; 
equation 
connect(L.n,emf.p):; 
connect(R.n,L.p); 
connect(SV.p,R.p):; 
connect(SV.n,g.p); 
connect(emf.n,g.p); 
connect(step.y,SV.v); 
connect(emf.flange ,J.flange_b); 
Psv SV * SV.i; 
Pr = Io * R.i; 
Pl ON Ls 
Pj = J.flange_b. tau * J.w; 
PT=Psv+Pr+Pl1+Pj+PT; 
alfa=der(J.w); 
end DCmotor; 
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El modelo implementado relaciona el calentamiento y la elon- 
gación de un cable aéreo desnudo con varios aspectos: 
= La corriente eléctrica que circula por el conductor. 


= Las condiciones ambientales. 


= Las condiciones de tendido. 


Para transportar grandes cantidades de energía 
eléctrica a través de largas distancias se utilizan 
líneas de transmisión como las que se mues- 
tran en la figura 9.1. La energía eléctrica viaja a 
través de los cables aéreos, que son conducto- 
res de electricidad que están suspendidos en el 
aire gracias a las torres que los soportan. El pe- 
so de los cables causa una deflexión en estos. 
Tal deflexión varía con el calentamiento que 
sufren los cables, debido al paso de la energía Figura 9.1 Línea de transmisión” 
eléctrica y a las condiciones ambientales. 


Tomada de [link:13] con licencia de Creative Commons. 
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La deflexión de los cables es un factor que incide en la seguridad de la 
línea. El diseñador debe prever que no se violen las distancias mínimas de 
seguridad. Para ello, debe estudiar la manera como se afecta la geometría 
de la línea en diferentes condiciones de operación. 

9.1 EL MODELO 


El modelo implementado permite simular simultáneamente dos fenómenos: 


= El calentamiento de un cable aéreo por el que circula una corriente 
eléctrica. 


= El efecto que el calentamiento tiene sobre la geometría de la curva que 
describe el cable. 
9.1.1 Modelo térmico estático 


El modelo térmico implementado es el sugerido por la norma técnica IEEE 
738 (véase [IEE07]). Se trata de un balance de calor en el que intervienen los 
siguientes fenómenos: 


= Calentamiento por efecto Joule. 

= Calentamiento por radiación solar. 
= Enfriamiento por convección. 

= Enfriamiento por radiación. 


La ecuación 9.1 representa la condición de equilibrio del calentamiento 
(balance de calor) de un conductor eléctrico al aire libre: 


1 


O = 
mC» 


¡MEP + Qs — Qe — gr] (9.1) 


en donde: 
= Tes la temperatura del conductor. 
= mC, es la capacitancia térmica del conductor. 


= Resla resistencia por unidad de longitud del conductor, que es función 
de la temperatura. 


= ] es la corriente por el conductor. El término R(T;)1? es la ganancia de 
calor por efecto Joule. 
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= (s esla ganancia de calor por radiación solar. 
= q¿€s la pérdida de calor por convección. 
= q, esla pérdida de calor por radiación. 
La norma IEEE 738 especifica los procedimientos para la estimación de 
Us» Qe Y Qr- 
9.1.2 Modelo térmico dinámico 


La ecuación 9.2 representa la dinámica del calentamiento de un conductor 
eléctrico al aire libre: 
di. 1 
dt  mC, 


[RTIA + Qs = Qe gr] (9.2) 


Se estudia aquí la solución de la ecuación con / constante, y con condición 
inicial 7.(0) = To. Aunque los términos q. y q, dependen de T., en los méto- 
dos de solución que se presentan se suponen constantes; esto significa que los 
métodos propuestos son válidos para cortos intervalos de tiempo (típicamente 
de 1 minuto). 


9.1.2.1 Método 1: aproximación de resistencia constante 


En este método se supone que R es independiente de 7. En estas condiciones 


se tiene: 
dí. 


9,3 
E (9.3) 
1 2 
a= [RI + Qs — Qe — qr] (9.4) 
id 
cuya solución es 
T-(t) = To + at (9.5) 


9.1.2.2 Método 2: aproximación de resistencia lineal con la temperatura 


En este método se supone una variación lineal de R con 7... Se supone, además, 
que se conoce el valor de R para dos temperaturas: 


RITA) = Hz R(Tyg) = Ru (9.6) 
de tal manera que la resistencia a una temperatura 7; está dada por 


(Rg — Ri) 


Fl Ea) = Ri | (T. Th) (Ta =z Tr) 


(9.7) 
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o lo que es igual: 


R(T.) =0T.+ 8 (9.8) 
(Ra — Ri) 
A B=R, —oTL (9.9) 
(y =TÍ) 
En estas condiciones, la ecuación 9.2 se convierte en 
dí, 1 
ea a [(oT. + BY + qs — de — qn] (9.10) 
A 1 2 
= To 4 T? y 9.11 
a “a [81% + qs — de — qr] (9.11) 
que puede escribirse en forma resumida así: 
dí, 
a = a0T. + bo (9.12) 
ar? 1 
= bn = Py ; 9.13 
o a, Ta [B1? + qs — de — Qr] (9.13) 


La solución de la ecuación 9.12 es 


bo, aolo + bo ¿ot 
00 00 


(9.14) 


9.1.2.3 Estimación de corriente. Método 1 


Supóngase que son conocidos Tp, T.(t) y t en la ecuación 9.5. Se requiere es- 
timar el valor de /. Para ello se despeja a: 


y posteriormente se despeja / de 9.4 


(9.16) 


e E 
o R 


9.1.2.4 Estimación de corriente. Método 2 


Supóngase que son conocidos Ty, T(t) y t en la ecuación 9.14. Se requiere 
estimar el valor de /. 
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Caso 1. Cambio de temperatura: de la ecuación 9.13 se obtiene: 


agma, 
Le ni bo = E [gs Ue Qr] (9.17) 
o rol mCp 


que en forma resumida se pueda expresar como: 


bo = dan + (9.18) 
con . : 
0= ES q mp 1 — de — dr] (9.19) 


Lo que permite expresar 9.14 como 


9a 
To(t) = Tyerot — 707 (y _ gaot) (9.20) 
a0 
La ecuación 9.20 se resuelva para ay mediante métodos numéricos. Pos- 
teriormente se calcula / a partir de 9.17: 


I=14/ aymCp (9.21) 
0 


Caso 2. Temperatura constante: debe asumirse la condición de estado esta- 
cionario y emplear: 


RI? + q3 =4e + Qr (9.22) 


9.1.3 Modelo mecánico 


El modelo mecánico del cable está ampliamente documentado en textos de in- 
geniería mecánica y eléctrica (véase, por ejemplo, [FB13]). Se trata de una ca- 
tenaria, tal como la que se muestra en la figura 9.2: está apoyada en A y B, con 
un desnivel Ay. La separación horizontal entre apoyos es S. La tensión longi- 
tudinal es Ten. La tensión horizontal es H. La longitud del conductor es L. El 
peso por unidad de longitud es W. La temperatura es 7. El punto más bajo (O) 
se ubica a una distancia S', del apoyo A y a una distancia Sg del apoyo B. La 
longitud del conductor desde el apoyo A hasta el punto más bajo es L 4. La lon- 
gitud del conductor desde el apoyo B hasta el punto más bajo es L y. La altura 
desde el punto más bajo hasta el apoyo en A es ya. La altura desde el punto 
más bajo hasta el apoyo en B es yg. La altura del apoyo A respecto al nivel de 
referencia es ha. 
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La flecha D es la máxima distancia vertical que hay entre la línea imagi- 
naria que une los dos apoyos y la catenaria. La flecha sucede en el punto en 
el que la tangente de la catenaria es igual a la pendiente de la línea imagina- 
ria que une los dos apoyos. Este punto está a una distancia horizontal > del 
punto más bajo. 


] 
! 
] 
—————, 
Sa 


| 
: . 


SB 
S ! 


Figura 9.2 Geometría de la catenaria 


9.1.3.1 Geometría 


La elevación a respecto al punto más bajo se calcula así: 
H Wz H 
y (E) = yy; cosh (57) (9.23) 


en donde 7 es la distancia horizontal al punto más bajo. Sea x la distancia 
horizontal al apoyo A; en esas condiciones se tiene: 


T=SA-1 (9,24) 
Y por tanto: 
H W(Sa — 2) dl 
= h 2 
y(z) py os ( 7 ) w (9.25) 
La altura del conductor en x respecto al nivel de referencia es 
h(2) =haA — Ya + y(z) (9.26) 


h(x) =ha — a cosh US + E cosh (LE) (9.27) 
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9.1.3.2 Cálculo de S 4 


La distancia del punto más bajo de la catenaria al apoyo más bajo es Spp: 


SpB= —Ñ-— + sinh 9.28 
O Misa E 


Spg es igual a S1 oa Sg según el primer apoyo sea o no el más bajo de 
los dos. Expresado de otra forma: 


i > 
di l SPB SsiAy>0 (9.29) 


A—SpB SiIAy<0 
9.1.3.3 Cálculo de la flecha 


Para determinar la flecha se calcula primero la pendiente m de la línea imagi- 
naria que une los dos puntos: 


Ay 
m= 


9.30 
ño (9.30) 
La tangente de la catenaria se obtiene derivando la ecuación 9.23: 

dy Wz 

— = sinh | —— 9.31 

de ( H ) qe 


El punto TF en el que la tangente de la catenaria iguala a m es, entonces: 


H A 
q = py *simh (2) (9.32) 


La flecha D es la diferencia entre la altura de la recta imaginaria que une 
los dos apoyos y, y la altura de la catenaria y¿, medidas en Tf: 


D = yr (Uf) — Ys (Ef) 

y(T7) = fecosh (22) — ff —m(S ay) (9.33) 
pa Wrf 

yla) = 17 cosh (5) - a 


9.1.3.4 Cálculo de la tensión horizontal 


La longitud total del cable L se obtiene con L = L1+Lp: 
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e WSa HH. WS 
La = y ino u ) Lo = iy ino u ) (9.34) 


La tensión longitudinal en el cable es? 


WS 
Ten = H cosh —— p 
en cos 5H (9.35) 


Consideramos ahora dos estados (O y 1 para un mismo cable. En cada uno 
de ellos especificamos las siguientes variables: 


= Tensión longitudinal, denotada por T'eng y Ten, para cada estado. 
= Tensión horizontal, denotada por Ho y H para cada estado. 

= Temperatura del conductor, denotada por Ty y T| para cada estado. 
= Longitud del conductor, denotada por Ly y L;¡ para cada estado. 


Las longitudes del conductor en los dos estados satisfacen: 


(9.36) 


Ten1 — Ten0 
L¡ = Lo 0 +a(T; — To) + Tn 


EA 


en donde a es el coeficiente de dilatación, E es el módulo de elasticidad y A es 
el área. 


Si se supone que W no cambia del estado 0 al 1, el valor de A; se obtiene 
al resolver: 


Hi. WSA Hi. W(S-=SA)Y 
sy son ( HH, Ja (E = 


Ho . WSaA Hi. W(S-— Sa) 
sinh | sinh 
W Ho W Ho 


1 WS WS 
P + a(Ti = 1) An cosh 2H, = Ho cosh mel (9.37) 


2A una distancia S/2 del punto más bajo. 
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9.2 PLANTAS DE EXPERIMENTACIÓN Y EXPERIMENTOS SUGERIDOS 


Planta de experimentación 2: Calentamiento de un cable aéreo 
desnudo. 


Presentación: en este experimento se explora la manera como se afecta la 
temperatura del conductor y su flecha al alterar la corriente y las condiciones 
ambientales a lo largo de un periodo de veinticuatro horas. 

Se han modelado dos perfiles: uno para la corriente y otro para la tem- 
peratura del aire (véase figura 9.3). Estos perfiles buscan simular la variabili- 
dad de las dos condiciones a lo largo del día. El usuario puede modificar los 
pertilesajustando los valores de In Umar mins Imaras Dlna Y Das: 

Las condiciones de viento (velocidad y dirección) también pueden 
ser modificadas por el usuario. En el experimento modelado estos valo- 
res se mantienen constantes a lo largo de las 24 horas. El usuario también 
puede modificar el día del año que se simula, y la posición geográfica 
del vano. 


11 13 16 18 21 23 
14 


Figura 9.3 Perfiles de corriente y temperatura de aire para el experimento 2 


Instrumentación?: el modelo cuenta con once parámetros ajustables or- 
ganizados en 3 grupos de controles (véase tabla 9.1). Como resultado del 
experimento, el programa despliega: 


= 8 curvas organizadas en 4 gráficos (véase tabla 9.2). 


= Una tabla de datos del comportamiento de 9 variables (véase tabla 9.3). 


Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 
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Experimento 2.1: Tiempos de respuesta. 


¿Qué tiempo de respuesta tiene el calentamiento del cable y la fecha, ante 
variaciones de corriente? Determine cuánto tiempo tarda en estabilizarse 
la temperatura del conductor y la flecha ante cambios bruscos de corriente. 
¿Estos tiempos son iguales a lo largo de las 24 horas del día? 


Experimento 2.2: Fuentes de calentamiento y enfriamiento. 


¿Qué factores inciden en la cantidad de calor que entra y sale del conduc- 
tor? Explore que efecto tiene la variación de las condiciones ambientales, 
eléctricas y geográficas en los flujos de calor. 


Experimento 2.3: Ubicación geográfica. 


¿En qué lugares de Colombia se calentaría más fácilmente un conductor? 
A partir de las condiciones geográficas y climáticas de varios lugares de 
Colombia, explore el calentamiento de los conductores en dichos lugares. 


Experimento 2.4: Estaciones. 


¿El fenómeno de calentamiento del conductor es semejante en todos los 
días del año? ¿Cómo inciden las estaciones en los países en donde estas 
suceden? Explore la incidencia que tiene la variación de las condiciones 
climáticas a lo largo del año para: 1) un lugar específico en Colombia, y 2) 
para un lugar del planeta con estaciones pronunciadas. 
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Experimento 2.5: Margen de cargabilidad. 


¿De qué factores depende en mayor medida el margen de cargabilidad? 
El margen de cargabilidad es la cantidad de corriente adicional que po- 
dría circular por el conductor sin que se alcancen las condiciones límite. 


Este margen varía a lo largo del día. Explore los factores que afectan más 
este margen. 


Tabla 9.1 Parámetros del experimento 2, “Calentamiento de un cable aéreo desnudo” 


Título: Elongación 
Descripción: El experimento propuesto permite visualizar cómo inciden en el calen- 
tamiento de un cable aéreo dos aspectos: 1) La corriente eléctrica que 
circula por el conductor. y 2) Las condiciones ambientales. 
Implementación Oscar Germán Duarte Velasco 
Créditos e-mail ogduartevO'unal.edu.co 
Parámetros 
Grupo nombre Modelica | nombre descripción 
Imin n Prueba 
Imaz 12 
Corriente 
Imin2 13 
Imax2 Il 
windV el.k Velocidad de viento Constant output value 
windDir.k Dirección del viento Constant output value 
Condiciones ambientales | to.Day Día del año Day of the year (1-365) 
Tmin Temperatura mínima de aire 
Tmazx Temperatura máxima de aire 
span.He Altitud Altitude above sea level in 
Ubicación geográfica m 
span.L Latitud Latitude in deg 


3La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 
hay datos tanto en español como en inglés. 
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Tabla 9.2 Figuras del experimento 2, “Calentamiento de un cable aéreo desnudo” 


fa ru 
Temperatura de conductor y de aire 


Temperatura de conductor y de aire 
Variación de la temperatura del conductor y del aire a 
lo largo de 24 horas 
Curva Descripción x Y 
Te Temperatura del har T 
conductor 
4 , Ta Temperatura del hour taCelcius 
Ic: (degC) vs (h) _ _ _ aire 
Ta : (degC) vs (h) 
fr A mm] 
Flujo de calor Ho de calor 
Flujos de calor en el conductor. Los flujos de calor por 
efecto Joule y por efecto del sol son ganancias de calor, 
mientras que los flujos de calor por radiación y conven- 
ción son pérdidas de calor. 
Curva Descripción z Y 
: : Joule Qj hour Qj 
Joule “(WW) vs (nj : Sol Qs hour Qs 
¿e : ps vs (h) Aire Qe hour Qe 
jre : (W) vs (h) PRNEo 
Radiación : (W) vs (h) Radiación | Qr hour Qr 
r Corriente h 

Corriente 


Perfil de corriente. Es la variación de corriente a lo lar- 
go de un periodo de 24H. Es el efecto de la variabilidad 
diaria de la demenada de energía eléctrica. 


Curva Descripción x Y 

I I hour I 
1: (A) vs (h) 

Flecha 


La flecha es la máxima distancia vertical existente en- 
tre una línea imaginaria que une los dos apoyos del 
conductor, y el conductor mismo. Esta gráfica muestra 
la variabilidad de la flecha a lo largo de un periodo de 


24 horas. 
Curva Descripción z 7) 
Flecha D hour sag 


Flecha * (m) vs (h) 
Y) 


Tabla 9.3 Variables en la tabla de resultados del experimento 2, “Calentamiento de un cable aéreo 


desnudo” 
Variable Descripción Unidades 
hour h 
dl degC 
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Variable Descripción Unidades 
taCelcius degC 

Qj Mi 

Qs W 

Qc W 

Qr W 

I A 

sag m 


Planta de experimentación 3: Capacidad de carga. 


Presentación: 

en este experimento se realiza un estudio de cargabilidad de una línea 
para una condición límite de temperatura en el conductor. Se calcula la 
máxima corriente permisible en la línea que no viola las condiciones de 
máxima temperatura de conductor permisible a lo largo de un periodo de 
24 horas. 

Se simula la variación de la temperatura ambiente mediante dos perfi- 
les diferentes (véase figura 9.4), y la variación de exposición solar según el 
modelo de la IEEE 738. La velocidad del viento se considera constante a lo 
largo de las 24 horas. 


Figura 9.4 Perfiles de temperatura de aire disponibles para el experimento 3 


Instrumentación”: el modelo cuenta con 4 parámetros ajustables organiza- 
dos en 2 grupos de controles (véase tabla 9.4). Como resultado del experi- 
mento, el programa despliega: 


= 2 curvas organizadas en 2 gráficos (véase tabla 9.5). 


= Una tabla de datos del comportamiento de 3 variables (véase tabla 9.6). 
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Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 3.1: Efecto de las condiciones ambientales. 


¿Qué impacto tienen las condiciones ambientales en la variación de la ca- 
pacidad de carga a lo largo del día? Explore la variabilidad de la capacidad 
de carga a lo largo del día, para diferentes condiciones ambientales. 


Experimento 3.2: Condición límite. 


¿Cómo afecta la determinación de la máxima temperatura permisible a la 
capacidad de carga? Explore el impacto de variar el valor de la máxima 
temperatura permisible sobre los valores máximo y mínimo de la capaci- 
dad de carga a lo largo del día. 


Experimento 3.3: Capacidad horaria. 


¿Qué tanto aumentaría la capacidad de carga máxima a lo largo del día, 
en comparación con la práctica usual de declarar una única capacidad de 
carga constante para las 24 horas? Determine el aumento máximo de la 
capacidad de carga de la línea a lo largo del día para diversas condicio- 
nes. Reflexione sobre qué condiciones del sistema de potencia deberían 
cambiarse para poder aprovechar ese margen. 


Experimento 3.4: Capacidad de carga por flecha. 


¿Cómo se calcularía la capacidad de carga en función de una flecha 
máxima permisible? Adapte el código fuente disponible para desarrollar 
un modelo que calcule la capacidad de carga de la línea para una flecha 
máxima permisible. 
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Tabla 9.4 Parámetros del experimento 3, “Capacidad de carga” 


Título: Capacidad de carga 

Descripción: En este experimento se realiza un estudio de cargabilidad (capacidad de 
carga o rating) de una línea para una condición límite de temperatura 
en el conductor. Se calcula la máxima corriente permisible en la línea 
que no viola las condiciones de máxima temperatura de conductor per- 
misible a lo largo de un periodo de 24 horas. Se simula la variación de 
la temperatura ambiente mediante dos perfiles diferentes, y la variación 
de exposición solar. La velocidad del viento se considera constante a lo 
largo de las 24 horas. 


Implementación Oscar Germán Duarte Velasco 
Créditos e-mail ogduartevOunal.edu.co 
Parámetros 
Grupo Nombre Modelica Nombre Descripción 
TAmin Temperatura mínima de aire 
Condiciones ambientales TAmazx Temperatura máxima de aire 
Vuto Velocidad de viento 
Condición límite TOCmazx Temperatura máxima de conductor 


Tabla 9.5 Figuras del experimento 3, “Capacidad de carga” 


Cargabilidad 


Cargabilidad 
Máxima corriente permisible sin violar temperatura 
máxima permisible en el conductor 


Curva Descripción T 7) 
Máxima capacidad de 

Imax ; hour Imax 
corriente 


Imax: (A) vs (m) 


Temperatura de aire 


Temperatura de aire 

Perfil de temperatura de aire 

Curva Descripción z y 

Ta Taire hour taCelcius 


Ta: (degé) vs a) 


Tabla 9.6 Variables en la tabla de resultados del experimento 3, “Capacidad de carga” 


Variable Descripción Unidades 
hour h 

Imax A 
taCelcius degC 


4La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 
hay datos tanto en español como en inglés. 
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Planta de experimentación 4: Análisis de flecha. 


Presentación: en este experimento se muestran los retratos de fase que in- 
volucran a la flecha, para evaluar el efecto que tienen la corriente, la tempa- 
ratura ambiente y la temperatura del conductor sobre la flecha. 

Para las simulaciones se han empleado los perfiles de corriente y tem- 
peratura de aire que se muestran en la figura 9.5. 


Imaz 


Imaz; 


Imino 


Imin1 
11 131 16 18 21 23 
14 


Figura 9.5 Perfiles de corriente y temperatura de aire para el experimento 4 


Instrumentación”: el modelo cuenta con 8 parámetros ajustables organiza- 
dos en 2 grupos de controles (véase tabla 9.7). Como resultado del experi- 
mento, el programa despliega: 


= 5 curvas organizadas en 5 gráficos (véase tabla 9.8). 


= Una tabla de datos del comportamiento de 5 variables (véase tabla 9.9). 


Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 4.1: Flecha vs temperatura de conductor. 


¿Qué influencia tienen las condiciones ambientales y la corriente en la re- 
lación entre flecha y la corriente? La relación entre flecha y temperatura 
de conductor puede aproximarse a una línea recta. Explore cómo se afecta 
esa recta con diferentes condiciones eléctricas y ambientales. 
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Experimento 4.2: Análisis de sensibilidad. 


¿La flecha es más sensible a los cambios de las condiciones eléctricas o a 
las ambientales? Explore qué tanto cambia la flecha ante modificaciones 
en las condiciones ambientales y eléctricas. 


Experimento 4.3: Aproximaciones de linea recta. 


¿Es adecuado modelar el comportamiento de la flecha con relaciones afi- 
nes (líneas rectas)? Efectúe ajustes de línea recta para las relaciones flecha- 
corriente, flecha-temperatura de aire y flecha-temperatura de conductor, 
y evalúe la correlación de esos ajustes. 


Experimento 4.4: Efecto del conductor. 


¿Cómo inciden los parámetros del conductor en la relación flecha- 
temperatura de conductor? Utilice el código fuente del modelo para ex- 
plorar la sensibilidad del ajuste de línea recta entre flecha y conductor a 
los parámetros del conductor. 


Experimento 4.5: Efecto del vano. 


¿Cómo inciden los parámetros del vano en la relación flecha-temperatura 
de conductor? Utilice el código fuente del modelo para explorar la sensi- 
bilidad del ajuste de línea recta entre flecha y conductor a los parámetros 
del vano. 


5La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 
hay datos tanto en español como en inglés. 


335 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


Tabla 9.7 Parámetros del experimento 4, “Análisis de flecha” 


Título: Análisis de flecha 
Descripción: En este experimento se muestran los retratos de fase que involucran a 
la flecha, para evaluar el efecto que tienen la corriente, la temperatura 
ambiente y la temperatura del conductor sobre la flecha 
Implementación Oscar Germán Duarte Velasco 
Créditos e-mail ogduartevOunal.edu.co 
Parámetros 
Grupo nombre Modelica nombre descripción 
Imin n Primer valor 
Corriente a B 
Imin2 13 
Imazx2 Ta 
TAmin Temperatura mínima de aire 
Ed E TAmazx Temperatura máxima de aire 
Condiciones ambientales z 
tf Perfil de temperatura 1.0= trapecio; 
2.0=exponencial 
Vuto Velocidad de viento 


Tabla 9.8 Figuras del experimento 4, “Análisis de flecha” 


Flecha vs Corriente 


Sag vs |: (m) Ys (A) 


Flecha vs Corriente 
Retrato de fase entre flecha y corriente 


Curva Descripción| x Y 


Sag vs I Flecha I sag 


7 - 
Flecha vs Temperatura de aire 


Sag vs Ta : (m) vs (degC) 


Flecha vs Temperatura de aire 
Retrato de fase entre flecha y temperatura de aire 


Curva Descripción zx Y 


Sag vs Ta Flecha taCelcius sag 


E 
Flecha vs Temperatura de conductor 


Sag vs 0 (mí) Ye (degú) E 


Flecha vs Temperatura de conductor 
Retrato de fase entre flecha y Temperatura de conductor 


Curva Descripción x y 


Sag vs Tc Flecha '¡T sag 
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r Corriente aplicada 
Corriente aplicada 
Perfil de corriente empleado en la simulación 
Curva Descripción z Y 
1 Corriente en el hoUE 1 

conductor 
1: (A) vs (h) 
A . 
Temperatura de aire 
Temperatura de aire 
Perfil de temperatura de aire empleado en la simulación 
dese lecis Curva Descripción| zx Y 
Ta Ta hour taCelcius 
Ta : (degC) vs (h) 
Tabla 9.9 Variables en la tabla de resultados del experimento 4, “Análisis de flecha” 

Variable Descripción Unidades 

I A 

sag m 

taCelcius degC 

T degC 

hour h 


Planta de experimentación 5: Catenaria. 


Presentación: la curva descrita por un cable suspendido entre dos soportes 
es una catenaria. La geometría de esta curva está determinada por el estado 
de operación (temperatura del conductor y tensiones mecánicas, principal- 
mente). En este experimento se puede analizar el cambio de la geometría 
de la catenaria ante cambios en las condiciones del vano o del tendido de 
la línea. 


Instrumentación(: el modelo cuenta con 10 parámetros ajustables organi- 
zados en 4 grupos de controles (véase tabla 9.10). Como resultado del expe- 
rimento, el programa despliega: 


= 1 curva organizada en 1 gráfico (véase tabla 9.11). 


337 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


= Una tabla de datos del comportamiento de 2 variables (véase tabla 
9.12). 


Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 5.1: Robustez del algoritmo. 


¿Bajo qué condiciones de simulación el algoritmo arroja valores correctos? 
Explore diversas combinaciones de parámetros para evaluar la robustez 
del algoritmo. 


Experimento 5.2: Condiciones de tendido. 


¿Qué efecto tienen las condiciones de tendido en la geometría de la curva? 
¿Por qué? Explore los cambios en la geometría debidos a variaciones en las 
condiciones de tendido. 


Experimento 5.3: Longitudes. 


¿Qué relación debe haber entre la geometría del vano y la longitud de ten- 
dido? Explore cómo debe cambiar la longitud de cable requerido, cuando 
se modifican las separaciones horizontales y verticales de los apoyos. 


Experimento 5.4: Tipos de conductor. 


¿Qué tipo de conductores se elongan más? Compare conductores de ca- 
pacidad semejante, pero de diferente tipo (por ejemplo ACSR vs AAAC). 
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¿Cómo afecta el calibre de un conductor la geometría de la catenaria? 
Compare la geometría de la catenaria correspondiente a conductores de 


diferente calibre. 


Tabla 9.10 Parámetros del experimento 5, “Catenaria” 


cla 


Título: Catenaria 
Descripción: La curva descrita por un cable suspendido entre dos soportes es una ca- 
tenaria. La geometría de esta curva está determinada por el estado de 
operación (temperatura del conductor y tensiones mecánicas, princi- 
palmente). En este experimento se puede analizar el cambio de la geo- 
metría de la catenaria ante cambios en las condiciones del vano o del 
tendido de la línea 
Implementación Oscar Germán Duarte Velasco 
Créditos e-mail ogduartevOunal.edu.co 
Parámetros 
Grupo nombre Modelica nombre descripción 
span.D Desnivel Desnivel de los apoyos en m 
Datos del vano p Y - = A Poy: 
span.S Vano horizontal Separación horizontal de los apo- 
yos en m 
span.L_0 Longitud de referencia Lenght of conductor in state of re- 
Condiciones de tendido ference in m 
span.Ten_0 Tensión de referencia Tension of conductor in state of 
reference in KgF 
span.T'_0 Temperatura de referen- | Temperature of conductor in state 


of reference in K 


Ajustes de simulación 


Sag.alpha0 


Alpha inicial 


Parámetros del conductor 


con. W Densidad lineal Linear weight in Kg/m 
con.E Módulo de elasticidad Module of elasticity KgE/cm2 
con.a Coeficiente de dilatación | Coefficient of thermal dilatation 


in 1/K 


con.R_ref 


Coeficiente de cambio 
térmico de resistencia 
eléctrica 


Linear resistence at T_refin ohm- 
sím 


SLa información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 


hay datos tanto en español como en inglés. 
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Tabla 9.11 Figuras del experimento 5, “Catenaria” 


Catenaria 


Catenaria 

Curva descrita por el cable entre dos soportes 
Curva Descripción En 7) 
Catenaria y x y 


Catenaría : (m) vs (m) 


Tabla 9.12 Variables en la tabla de resultados del experimento 5, “Catenaria” 


Variable Descripción Unidades 
x m 
y m 


9.3 LA IMPLEMENTACIÓN 


Los parámetros del conductor y del vano se almacenan en registros (record) 
separados denominados ConductorData y SpanData. El día del año y la hora 
del día se almacenan en un tercer registro cuyo nombre es TimeData. Las tablas 
9.13 a 9.15 muestran los parámetros de cada registro. 


Tabla 9.13 Parámetros en el registro ConductorData 


declaración significado unidades 
Real D Diámetro externo mm 
Real a Coeficiente de dilatación 1/K 
Real E Módulo de elasticidad Kg/cm? 
Real W Peso lineal Kg/m 
Real A Área de sección transversal cm? 
Real C Capacitancia térmica lineal J/K 
Real R_ref Resistencia eléctrica lineal Q/m 
Real T_ref Temperatura de referencia tE 

Real alpha Pendiente de cambio de resistencia n/K 
Real abs =0.5 Absorbidad =- 

Real emi =1.0 Emisividad - 
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Tabla 9.14 Parámetros en el registro SpanData 


declaración significado unidades 
Real He Altitud sobre el nivel del mar m 
Real L Latitud E 
Real Z1 Azimut de la línea y 
Real S Longitud de vano m 
Real Dy Desnivel de los soportes m 
Real T_O Temperatura del conductor en el estado de referencia K 
Real Ten_0 Tensión del conductor en el estado de referencia KgrF 
Real L_0 Longitud del conductor en el estado de referencia m 
Tabla 9.15 Parámetros en el registro TimeData 

declaración significado 

Integer Day Día del año (1-365) 

Real Hour Hora del día (0-24, 13.5 significa 1:30 pm) 


9.3.1 Modelo térmico 


Se han definido 14 funciones para la implementación del modelo térmico 
(véase tabla 9.16). También se han diseñado las siguientes clases: 


Tabla 9.16 Funciones para el modelo térmico 


Función Calcula: 

AirConductivity Conductividad térmica del aire como función de la tempera- 
tura de la película de aire 

AirDensity Densidad del aire como función de la temperatura de la pelí- 
cula de aire 

AirViscosity Viscosidad del aire como función de la temperatura de la pelí- 
cula de aire 

AngleFactor Factor de corrección para las pérdidas de calor por convección 
en como función del ángulo entre el viento y el conductor 

asinh asinh(x) 

ConvectionFlow Pérdidas de calor por convección 


ForcedConvectionHigh 


Pérdidas de calor por convección forzada para velocidades de 
viento elevadas 


ForcedConvectionLow 


Pérdidas de calor por convección forzada para velocidades de 
viento bajas 


ForcedConvection Pérdidas de calor por convección forzada para cualquier velo- 
cidades de viento 

NaturalConvection Pérdidas de calor por convección natural 

FilmTemperature Temperatura de película de aire como función de las tempera- 
turas de aire y de conductor 

SolarAltitude Altitud solar como función de la latitud geográfica, el día del 
año y la hora del día 

SolarAzimuth Altitud solar como función de la latitud geográfica, el día del 
año y la hora del día 

SolarFlux Ganancia de calor solar como función de la altitud solar, la al- 


titud geográfica, azimut solar, azimut del vano y tipo de atmós- 
fera. 
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= ConvectionHeatFlow: un modelo similar al modelo HeatTransfer. 
Convection de la librería estándar, pero cuyos parámetros dependen de 
los parámetros del conductor, del vano y del tiempo. 


= SolarHeatFlow: un modelo similar al modelo HeatTransfer .Pres 
cribedHeatFlow de la librería estándar, pero cuyos parámetros depen- 
den de la posición del vano y del sol. 


= StandAloneHeatingResistor: un modelo similar al modelo Electri- 
cal.Analog.Basic.HeatingResistor de la librería estándar, que tam- 
bién calcula la ganancia de calor debida al efecto Joule del propio 
conductor. 


= Conductor: es una capacitancia térmica con un puerto que da una señal 
de temperatura. 


9.3.2 Modelos mecánico y geométrico 


Los modelos mecánico y geométrico se implementan mediante cuatro funcio- 
nes (tabla 9.17) y cuatro clases principales: 


Tabla 9.17 Funciones para los modelos mecánico y geométrico 


Función Calcula: 

CatenaryLenght Ecuación 9.34 
CatenarySag Ecuación 9.33 
CatenarySa Ecuación 9.29 
CatenaryXbar Ecuación 9.23 


= CatenaryStateChange: esta clase es la implementación de las ecua- 
ciones de cambio de estado 9.36 y 9.37. (véase archivo MyStandAlone- 
Line.mo). Es quizás la clase más importante del modelo mecánico. En 
esta clase se establece que el modelo debe satisfacer la nueva condicón 
de longitud dada en 9.34. Para acelerar la solución de las ecuaciones de 
cambio de estado, puede establecerse un punto de inicio para a = H/W 
que ayude al algoritmo. Se sugiere usar a. = 300 ?. 


= Catenary: es una clase virtual (partial) que une los modelos térmi- 
co, mecánico y geométrico (véase figura 9.3). Implementa la ecuación 


7A manera de ejemplo, las simulaciones numéricas por defecto del modelo encuentran un valor de 
a = 394,7 parat =0. 
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9.2 como un Conductor (es decir, como una capacitancia térmica), cu- 
yo puerto de calor tiene acoplados los modelos de flujos de calor (efecto 
Joule q.;, radiación solar q;, convección q. y radiación q,). La tempera- 
tura del aire TT, se incluye como una temperatura prescrita. 


De otra parte, tiene también un componente de la clase CatenaryState 
Change; la temperatura del Conductor se usa como entrada para el aná- 
lisis del Cambio de Estado, cuyo principal resultado es el cálculo de la 
flecha D. Para usar esta clase, debe diseñarse una clase derivada de tal 
manera que se establezca el valor de la corriente eléctrica /. Véase el 
archivo 9.5. 


= ElectricalCatenary: es una clase derivada de la clase Catenary, en 
la que una señal de corriente eléctrica se acopla al conductor. 


= StandAloneCatenary: es una clase derivada de la clase Catenary, en 
la que el valor de la corriente eléctrica es directamente un Real. En el 
archivo 9.24 se muestra cómo usar esta clase para unas condiciones es- 
pecíficas de simulación. 


D 
Ed 
=l 
3 

SS 

¡O) 
v 

- 
3 

£ 

YN 


Figura 9.3 Modelo Catenary 


Los parámetros empleados por defecto corresponden a un caso real de 
un vano ubicado en una red de transmisión de 230KV en Bogotá, Colombia. 
Dichos datos se muestran en la tabla 9.18. 
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Tabla 9.18 Parámetros para la implementación por defecto 


Parámetros de vano 


Conductor Peacock 

Altitud 2600 msnm 

Latitud 4,779423 Norte 

Azimut 76,14 

Separación horizontal entre soportes 82,31 m 

Diferencia de nivel entre soportes 0,4; m 

Tensión longitudinal nominal 2970 Kgf 
Parámetros de conductor 

Diámetro externo 24,2 mm 

Resistencia lineal a 25%C 9,7 x 107? ohm/m 

Resistencia lineal a 75%C 0,000116 ohm/m 

Masa lineal de aluminio 0,79716 Kg/m 

Masa lineal de acero 0,31227 Kg/m 

Peso lineal 1,16 Kg/m 

Módulo de elasticidad nominal 0,7530 x 10% KG/cm? 

Coeficiente de dilatación nominal 19,73 * 107% 1/C 

Área de sección transversal 3,4638 cm? 


9.3.3 Listado de archivos 


La tabla 9.19 muestra el listado de los archivos fuente de la implementación 
del modelo. 


Tabla 9.19 Archivos del modelo 


Número Archivo 

9.1 AirConductivity.mo 

9.2 AirDensity.mo 

9.3 AirViscosity.mo 

9.4 AngleFactor.mo 

9.5 Catenary.mo 

9.6 CatenaryLenght.mo 

9.7 CatenarySa.mo 

9.8 CatenarySag.mo 

9.9 CatenaryStateChange.mo 
9.10 CatenaryX.mo 

9.11 CatenaryXbar.mo 

9.12 Conductor.mo 

9.13 ConductorData.mo 

9.14 ConvectionFlow.mo 

9.15 ConvectionHeatFlow.mo 
9.16 Curve.mo 

9.17 DynamicCurve.mo 

9.18 ElectricalCatenary.mo 
9.19 FilmTemperature.mo 
9.20 ForcedConvection.mo 
9.21 ForcedConvectionHigh.mo 
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9.22 ForcedConvectionLow.mo 
9.23 MyElectricalLine.mo 

9.24 MyStandAloneLine.mo 
9.25 NaturalConvection.mo 
9.26 Rating.mo 

9.27 SagAnalysis.mo 

9.28 SolarAltitude.mo 

9.29 SolarAzimuth.mo 

9.30 SolarFlux.mo 

9.31 SolarHeatFlow.mo 

9.32 SpanData.mo 

9.33 StandAloneCatenary.mo 
9.34 StandAloneHeatingResistor.mo 
9.35 TimeData.mo 

9.36 asinh.mo 

9.37 package.mo 


Archivo 9.1 AirConductivity.mo 


Archivo 9.2 AirDensity.mo 


Archivo 9.3 AirViscosity.mo 


345 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


Archivo 9.4 AngleFactor.mo 


Archivo 9.5 Catenary.mo 
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Archivo 9.6 CatenaryLenght.mo 
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Archivo 9.7 CatenarySa.mo 


Archivo 9.8 CatenarySag.mo 


Archivo 9.9 CatenaryStateChange.mo 
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Archivo 9.10 CatenaryX.mo 


Archivo 9.11 CatenaryXbar.mo 


Archivo 9.12 Conductor.mo 


Archivo 9.13 ConductorData.mo 
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Archivo 9.14 ConvectionFlow.mo 


Archivo 9.15 ConvectionHeatFlow.mo 
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Archivo 9.16 Curve.mo 


Archivo 9.17 DynamicCurve.mo 
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Archivo 9.18 ElectricalCatenary.mo 


Archivo 9.19 FilmTemperature.mo 


Archivo 9.20 ForcedConvection.mo 


jrithm 
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Archivo 9.21 ForcedConvectionHigh.mo 


Archivo 9.22 ForcedConvectionLow.mo 
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Archivo 9.23 MyElectricalLine.mo 


Archivo 9.24 MyStandAloneLine.mo 
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Archivo 9.25 NaturalConvection.mo 


Archivo 9.26 Rating.mo 
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Archivo 9.27 SagAnalysis.mo 
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Archivo 9.28 SolarAltitude.mo 


Archivo 9.29 SolarAzimuth.mo 
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Archivo 9.30 SolarFlux.mo 
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Archivo 9.31 SolarHeatFlow.mo 


Archivo 9.32 SpanData.mo 
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Archivo 9.33 StandAloneCatenary.mo 


Archivo 9.34 StandAloneHeatingResistor.mo 


Archivo 9.35 TimeData.mo 


Archivo 9.36 asinh.mo 
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Archivo 9.37 package.mo 
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EVOLUCIÓN DE ENFERMEDADES 


El modelo representa la evolución de enfermedades infecciosas. 
Las poblaciones de las especies involucradas se representan por 
compartimentos. Se modela el tamaño de la población de cada 
compartimento y las interacciones entre estos. 


La evolución de las enfermedades infecciosas 
es uno de los temas de investigación de la epi- 
demiología. Los modelos matemáticos de es- 
tos fenómenos permiten realizar experimentos 
computacionales que ayudan a analizar la pro- 
pagación de las enfermedades y, eventualmen- 
te, realizar predicciones. 

Los modelos deben representar los meca- 
nismos de infección y recuperación de la en- 
fermedad, así como el nacimiento y muerte de 
individuos. En ocasiones, en estos procesos in- 


Figura 10.1 Aedes aegypty. Insecto 
transmisor del Dengue! 


tervienen poblaciones de diferentes especies, o subpoblaciones de una misma 


especie. 


YFoto tomada de http://www. saludputumayo.gov.co. 
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Se presenta aquí una implementación que permite ensamblar modelos 
relativamente sofisticados sin la necesidad de escribir explícitamente el con- 
junto completo de ecuaciones diferenciales y algebraicas. Los primeros mo- 
delos presentados tienen pocos compartimentos (2 o 3) y, posteriormente, se 
desarrollan casos más complejos (hasta 19 compartimentos). 


10.1 EL MODELO 


Los modelos aquí explicados han sido compilados e implementados en 
[Cam12]. La estrategia básica consiste en identificar las especies involucradas 
en el proceso de propagación de la enfermedad y realizar una partición?. de su 
población. Cada uno de los subconjuntos de la partición es un compartimento. 
Las poblaciones de los compartimentos evolucionan con el tiempo debido a 
fenómenos tales como nacimientos, muertes, infecciones y recuperaciones de 
la enfermedad. 

Para cada compartimento se plantea una ecuación dinámica que describe 
la rata de cambio del tamaño de la población x. La forma general de la ecuación 
es: 


T= . entradas — y salidas (10.1) 


en donde > entradas representa el ingreso de individuos al compartimento 
y » salidas, el egreso. Es usual que cada uno de los términos que aparecen 
en las sumatorias dependa del tamaño de la población de uno o más de los 
compartimentos del modelo. 

En los modelos que se presentan a continuación hay dos especies 
involucradas: 


= La especie que sufre la enfermedad, que será identificada como la especie 
de humanos. 


= La especie que sirve como transmisora de la enfermedad (como vector 
de la enfermedad) que será identificada como la especie de mosquitos. 


10.1.1 Modelo SIR 


En este modelo solo se considera la especie de humanos. Su población se 
subdivide en tres compartimentos, que dan origen al nombre del modelo: 


2La partición de un conjunto es la definición de subconjuntos de dicho conjunto con dos propiedades: 
1) los subconjuntos son disyuntos, es decir no tienen elementos en común o, lo que es igual, su intersección 
es vacía, y 2) la unión de los subconjuntos es igual al conjunto original 


364 


EVOLUCIÓN DE ENFERMEDADES 


= S -Susceptibles: individuos que no han contraído la enfermedad pero que 
pueden llegar a contraerla. 


= I -Infectados: individuos que han contraído la enfermedad y aún no la 
han superado. 


= R -Recuperados: individuos que se han superado la enfermedad. 


Los tamaños de las poblaciones de estos compartimentos se representan 
por S, I, y R, respectivamente. En el modelo SIR, las dinámicas de las pobla- 
ciones se rigen por las siguientes reglas: 


1. Un individuo puede pasar del compartimento S al Ia través del contagio. 


11. Un individuo puede pasar del compartimento l al R a través de la recu- 
peración. 


11. Los individuos recuperados adquieren inmunidad y, por tanto, no vuel- 
ven a enfermarse. 


Iv. La población total de la especie es constante. 


v. La dinámica de la enfermedad es mucho más rápida que la dinámica 
natural de la especie y, por tanto, no se modelan los nacimientos ni las 
muertes. 


El contagio se da por el contacto entre un individuo susceptible y uno in- 
fectado. Por esta razón, el número de contagios es directamente proporcional 
al producto SI (proporcional a la probabilidad de encuentro entre un indi- 
viduo infectado y uno susceptible), con constante de proporcionalidad 6. El 
número de recuperaciones es proporcional al número de infectados 1; la tasa 
de recuperación y es el inverso del tiempo de recuperación t, = 1/7. Esta di- 
námica se representa gráficamente en la figura 10.2. La ecuación 10.2 muestra 
las relaciones matemáticas del modelo: 


Ecuaciones del modelo SIR 

Ss = —BSI 

Í = BSI-=w1 (10.2) 
R = yl 
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BSI yl 


Figura 10.2 Diagrama del modelo SIR 


10.1.2 Modelo SIR con nacimientos y muertes 


El modelo SIR puede modificarse para incluir el fenómeno de muerte natu- 
ral en cada compartimento. La muerte natural se modela como proporcional 
a la población de cada compartimento, con una constante de proporcionali- 
dad y igual para todos los compartimentos. Para compensar la disminución 
de la población, se consideran los nacimientos, que igualan en cantidad a las 
muertes. 

La figura 10.3 muestra el diagrama correspondiente al modelo. Las ecua- 
ciones correspondientes son las siguientes: 


Ecuaciones del modelo SIR con nacimientos y muertes 
S = uWN-—BSI—uS 

Í BSI—yI-— ul (10.3) 
R = y- ul 

N = S+I+R 


Figura 10.3 Diagrama del modelo SIR con nacimientos y muertes 


10.1.3 Modelo SIS 


En algunas enfermedades la recuperación no asegura inmunidad. En otras pa- 
labras, es posible adquirir la enfermedad más de una vez. Como se muestra 
en la figura 10.4, el modelo SIS (sin nacimientos ni muertes) solo tiene dos 
compartimentos: S e I; los individuos que se recuperan pueden enfermarse de 
nuevo, y por tanto pasan al compartimento de los susceptibles. Las ecuaciones 
del modelo son las siguientes: 
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Ecuaciones del modelo SIS 
Ss = —BSI+ylI (10.4) 
il = fBSI=0qyl 


Figura 10.4 Diagrama del modelo SI 


10.1.4 Modelo SIR-SI 


En este modelo se considera también la dinámica de la especie transmisora de 
la enfermedad (la especie vector). Para distinguir las dos especies se utilizarán 
los subíndices h y v para referirnos a las poblaciones de humanos y vectores, 
respectivamente. La figura 10.5 ilustra el modelo, cuyas ecuaciones se presen- 
tan en 10.5 y se explican a continuación: 


Figura 10.5 Diagrama del modelo SIR-SI 


10.1.4.1 Modelo del vector 


El vector se representa por dos compartimentos, uno S y uno I. Los mosquitos 
infectados son los que servirán de transmisores de la enfermedad. La proba- 
bilidad de que un mosquito se infecte es proporcional a la probabilidad de 
encuentro entre un mosquito no infectado y un humano infectado, es decir, 
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es proporcional al producto S,, 17 / Ny. Hay dos elementos más que intervie- 
nen: la tasa de picadura (representada por b) y la probabilidad de que el mos- 
quito resulte infectado (representada por p,,). 


10.1.4.2 Modelo del humano 


La población humana se representa por tres compartimentos, uno S, uno I y 
uno R. La probabilidad de que un humano se infecte es proporcional a la pro- 
babilidad de encuentro entre un mosquito infectado y un humano susceptible, 
es decir, es proporcional al producto Sy, 1,,/N,. También intervienen: la tasa 
de picadura (representada por b) y la probabilidad de que el humano resulte 
infectado (representada por p»,). 


Ecuaciones del modelo SIR-SI 

Vector Humano 

S) = puNp=By—=Hw8Sy Sh = UN Br— UlnSr 

Ll, = PBu— pol, Ln = Br YLh — UnIh (10.5) 
Rh = Vih— UnRr 

N, = Sy +, N» => Sh + La +ERh 

By = PvbSyLr / Nr, Ph = ProSyL,/Ny 


10.1.5 Modelo SIR-SI con dos serotipos 


Este modelo contempla dos variantes de la enfermedad, caracterizada por dos 
serotipos. Los serotipos se identifican por los subíndices 1 y 2. El número de 
compartimentos se incrementa ahora así: 


= La población de vectores infectados (1,,) se subdivide en dos comparti- 
mentos: 
» 1,,: los vectores infectados por el serotipo 1. 
e [,,: los vectores infectados por el serotipo 2. 
= La población de humanos infectados (1) se subdivide en cuatro com- 
partimentos: 
* [;,,: los humanos infectados por el serotipo 1. 
. [;,,: los humanos infectados por el serotipo 2. 


. [;,,: los humanos infectados por el serotipo 1 que previamente se 
habían infectado (y recuperado) con el serotipo 2. 
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. [;,,,: los humanos infectados por el serotipo 2 que previamente se 
habían infectado (y recuperado) con el serotipo 1. 


= La población de humanos recuperados (Ry) se subdivide en tres com- 


partimentos: 


* R»,: los humanos recuperados después de haberse infectado 
(únicamente) con el serotipo 1. 


* Rp,: los humanos recuperados después de haberse infectado (úni- 


camente) con el serotipo 2. 


» Rp: los humanos recuperados después de haberse infectado con 


ambos serotipos. 


El modelo se representa gráficamente en la figura 10.6. La ecuación 10.6 
consigna el conjunto de expresiones matemáticas del modelo: 


Ecuaciones del modelo SIR-SI con dos serotipos 
Vector 

Sy = pNy— Bor — Boz — o So 

Do == Ber — tido 

Ta. E De ls 

Ny = Si+lo 

Bu = PvdSylIn, + Ino )/Nn 

Bv» =  PvbdSulInz + Inj2)/Nn 

Humano 

Sh = uN Bhi — Pho — UnSh 

Ran = VLlhio + YLho, — PnRh 

N, = Sh+lIn+Rhn 

Serotipo 1 Serotipo 2 

de = Br, — YLn, — nl, Tha =  Bha — YLhz — hno 

Ri = vn —onRa, —BroRn, | Rms = Yin — UnRns — Bri Ras 
Pre = BB == Wla L Ina = Bulbia="Da tha 
Phi =  PrbSolo, [No Bro =  PhroSuly,/No 


(10.6) 
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Bra Rho 


Figura 10.6 Diagrama del modelo SIR-SI con dos serotipos de virus 


10.1.6 Modelo del dengue 


En [Cam12] se propone un modelo para la propagación del dengue, y se iden- 
tifican los parámetros correspondientes para el caso colombiano. El modelo 
separa la población de humanos en dos poblaciones diferentes: 


= La población de jóvenes, identificada con el subíndice j. 


= La población de adultos, identificada con el subíndice a. 


Para cada una de estas subpoblaciones se formula un modelo SIR-SI con 
dos serotipos, como el presentado en la sección 10.1.5. Sobre ese modelo, se 
adiciona la migración de cada compartimiento de la población joven a su ho- 
mólogo de la población adulta, a una rata o: que representa la rapidez del paso 
de joven a adulto. 
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En esas condiciones, el diagrama resultante es el que se muestra en la fi- 
gura 10.8. La ecuación 10.7 consigna el conjunto de relaciones matemáticas 


correspondientes. 


Ecuaciones del modelo para el dengue 


Vector 

Sy = Ny — Boj — Bua — MuSv 

loz = Bvj — Holouz 

log  =  Buz— Huluz 

Ny = Su + Iv 

Boy =  PubSu(Tz, + 1591 +Tay + la21)/Nh 

Bva =  PubSy(Iz, + I5,9 + lag + La12)/Nn 

Humano 
Joven Adulto 

S; = uN¿- Bj] — Bjo — MjSj — 98 Sa =  HNa— Baz — Bag — HaSa + 08; 
Bj == MLjy9 Igo — AG Rj AR Ba = Waza + Yazy — taRa +aR; 
Nj = Si¡+1+R; Na = Sa+la+Ra 


Joven-Serotipo 1 


Joven-Serotipo 2 


51 = Bj — VE gig Ly 

Bo =  VEjy — BjRgy — Bjg Rig] AR 
bio  =  Bj2Rjy — Vlj19 — Potg1a 7 Ly 
Pi =  PjPSvyloy /Nu 


lso Bj ja Mjlja Ly 

Bjg  =  Wjg = MjRja — Bj Rjo — AR 
jar == PiBj7 Via — Pitja 7 Algo 
Bjo  =  PjbSvlvz/Nv 


Adulto-Serotipo 1 


Adulto-Serotipo 2 


lay  = Bay — Waz — Halaj +01, 

Ray  =  Ylaj — HaRay — BaghRay +0aRj, 
laz =  BaghRaj — Ylazz — HMalaja + ALjyo 
Baz =  PabSylyy/Ny 


lag  = Paz — Vaz — Malas + 0Lj, 

Rag = vaz — HaRaz — Baz Raz +aRj, 
La. = aj Ray — Yla — Hala al; 
la91 Ba] Raz lao] lag1 + 9591 
Bas =  PadSylvg/Ny 


(10.7) 
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- 
- 


== 


Figura 10.8 Diagrama del dengue modelo SIR-SI con dos serotipos de virus y población de humanos 


separad por edades. Las líneas punteadas representan la migración de las poblaciones jóvenes a adultas, 


aX, donde X; es la población del compartimento joven 
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10.2 PLANTAS DE EXPERIMENTACIÓN Y EXPERIMENTOS SUGERIDOS 


Planta de experimentación 6: Modelo Susceptible-Infectado- 
Recuperado. 


Presentación: modelo de propagación de una enfermedad con tres compar- 
timentos de individuos: susceptibles, infectados y recuperados. El modelo se 
presenta en la sección 10.1.1. 


Instrumentación?: el modelo cuenta con 4 parámetros ajustables organiza- 
dos en 2 grupos de controles (véase tabla 10.1). Como resultado del experi- 
mento, el programa despliega: 


= 6 curvas organizadas en 4 gráficos (véase tabla 10.2). 
= Una tabla de datos del comportamiento de 4 variables (véase tabla 


10.3). 


Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 6.1: Estado estacionario. 


¿Qué factores inciden en los tamaños de las poblaciones cuando se es- 
tabiliza el comportamiento? Explore cómo afectan los parámetros del 
modelo a los valores finales de las poblaciones susceptibles, infectadas y 
recuperadas. 


Experimento 6.2: Tiempos de respuesta. 


¿Qué factores inciden en la rapidez con que se estabiliza el comportamien- 
to? Explore cómo afectan los parámetros del modelo a los tiempos en que 
se alcanzan los valores finales de las poblaciones susceptibles, infectadas y 
recuperadas. 


373 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


Experimento 6.3: Infección máxima. 


¿Qué combinación de factores causa la máxima infección? Explore cómo 
afectan los parámetros del modelo al valor máximo (valor pico) de la po- 
blación de infectados. 


Experimento 6.4: Tiempo de infección máxima. 


¿De qué depende que el pico de infección suceda antes o después? Explore 
cómo afectan los parámetros del modelo al tiempo en que sucede el pico 
de la población de infectados. 


Tabla 10.1 Parámetros del experimento 6, “Modelo Susceptible-Infectado-Recuperado” 


Título: Modelo SIR 
Descripción: Modelo de propagación de una enfermedad con tres compartimentos 
de individuos: Susceptibles, Infectados y Recuperados 
Implementación Oscar Germán Duarte Velasco 
Créditos e-mail ogduartev'unal.edu.co 
Parámetros 
Grupo nombre Modelica nombre descripción 
beta Tasa de contagio Probabilidad de contagio cuando hay 
Enfermedad ii coñtacto 
trec Tiempo de recuperación Número de días que tarda en recupe- 
rarse un infectado 
si NI Infectados iniciales Número de individuos infectados al 
Población inicio de la simulación 
NR Recuparados iniciales Número de individuos recuperados al 
inicio de la simulación 


3La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 
hay datos tanto en español como en inglés. 
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Tabla 10.2 Figuras del experimento 6, “Modelo Susceptible-Infectado-Recuperado” 


Poblaciones 


Susceptibles Andmauos) vs (días) 
Infectados : (Individuos) vs (días) 
Recuperados : (Individuos) vs (días) 


Retrato S-] 


S vs 1: (Individuos) vs (Individuos) 


Retrato S-R 


SvsR: (Individuos) vs (Individuos) 


Retrato |-R 


1 vs R *(Índividuos) vs (Individuos) 


Poblaciones 

Curva Descripción zx 7) 
Evolución del número 

Susceptibles de individuos suscepti- | día S.pob 
bles 
Evolución del número ¿ 

Tnistados de individuos infectados Ala pad 
Evolución del número 

Recuperados | de individuos recupera- | día R.pob 
dos 

Retrato S-I 

Curva Descripción z Y 
Trayectoria en el espa- 
cio Susceptibles (verti- 

SvsI cal) - Infectados (hori- Ipob | S.pob 
zontal) 

Retrato S-R 

Curva Descripción T Y 
Trayectoria en el espa- 
cio Susceptibles (verti- 

ave cal) - Recuperados (ho- R.pob | S.pob 
rizontal) 

Retrato I-R 

Curva Descripción T Y 
Trayectoria en el es- 
pacio Infectados (verti- 

Lyon cal) - Recuperados (ho- R.pob | L-pob 
rizontal) 


375 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


Tabla 10.3 Variables en la tabla de resultados del experimento 6, “Modelo 
Susceptible-Infectado-Recuperado” 


Variable Descripción Unidades 
Día Días 

S.pob Individuos 
Ipob Individuos 
R.pob Individuos 


Planta de experimentación 7: Modelo Susceptible-Infectado- 
Recuperado con nacimientos. 


Presentación: modelo de propagación de una enfermedad con tres com- 
partimentos de individuos: susceptibles, infectados y recuperados. Incluye 
muertes y nacimientos. El modelo se presenta en la sección 10.1.2. 


Instrumentación?: el modelo cuenta con 5 parámetros ajustables organiza- 
dos en 2 grupos de controles (véase tabla 10.4). Como resultado del experi- 
mento, el programa despliega: 


= 7 curvas organizadas en 5 gráficos (véase tabla 10.5). 
= Una tabla de datos del comportamiento de 4 variables (véase tabla 


10.6). 


Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 7.1: Frecuencia. 


¿De qué factores depende la frecuencia de aparición de la infección? Ex- 
plore cómo afectan los parámetros del modelo el tiempo entre picos de 
infección. 


Experimento 7.2: Linealización S-R. 


Obtenga un ajuste de línea recta para la relación entre el número de suscep- 
tibles y el número de recuperados. Explore cómo se afectan los parámetros 
de la recta ajustada con los diferentes parámetros del modelo. 
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Experimento 7.3: Infección mínima. 


¿Qué factores inciden en los valores mínimos de infección? Explore cómo 
afectan los parámetros del modelo el tamaño de la población de infectados 


más bajo entre dos picos sucesivos. 


Tabla 10.4 Parámetros del experimento 7, “Modelo Susceptible-Infectado-Recuperado con nacimientos” 


Título: Modelo SIR con nacimientos 
Descripción: Modelo de propagación de una enfermedad con tres compartimentos 
de individuos: Susceptibles, Infectados y Recuperados. Incluye muertes 
y nacimientos. 
Implementación 
Créditos e-mail 
Parámetros 
Grupo nombre Modelica nombre descripción 
S.beta Tasa de contagio Probabilidad de contagio cuando 
Enfermedad hay un contacto 
S. tree Tiempo de recuperación Número de días que tarda en recu- 
perarse un infectado 
mu Tasa de nacimientos (*e-6) Tasa de natalidad y muerte natural 
ñ S.NI Infectados iniciales Número de individuos infectados 
Poblaciones al inicio de la simulación 
S.NR Recuparados iniciales Número de individuos recupera- 
dos al inicio de la simulación 


Tabla 10.5 Figuras del experimento 7, “Modelo Susceptible-Infectado-Recuperado con nacimientos” 


fr 


Poblaciones 


Poblaciones 


Curva Descripción o y 


¿ Evolución del número de : 
Susceptibles individuos susceptibles S.día | S.S.pob 


Evolución del número de A 
Infectados individuos infectados S.día | S.Lpob 


Susceptibles : (Individuos) vs (alas) — - 
Infectados : (Individuos) vs (días) Recuperados Evolución del número de S.día 
Recuperados : (Individuos) vs (días) individuos recuperados dl 


4La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 
hay datos tanto en español como en inglés. 
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Infectados 


4 
S vs! : (Individuos) vs (Individuos) 


Retrato S-R 


25,15. 632.28 41 64 
SvsR: (Individuos) vs (Individuos) 


Retrato |-R 


Infectados 

Curva Descripción z 7) 
Evolución del número de in- ¿ 

Infectados dividiios infectados S.día S.I.pob 

Retrato S-I 

Curva Descripción z 7) 
Trayectoria en el espacio 

SvsI Susceptibles (vertical) - |S.Ipob | S.S.pob 
Infectados (horizontal) 

Retrato S-R 

Curva Descripción z 7) 
Trayectoria en el espacio 

SvsR Susceptibles (vertical)  - | S.R.pob | S.S.pob 
Recuperados (horizontal) 

Retrato I-R 

Curva Descripción z 7) 
Trayectoria en el espacio In- 

IvsR fectados (vertical) - Recupe- | S.R.pob | S.I.pob 
rados (horizontal) 


vs R* (Individuos) vs (Individuos) 


Tabla 10.6 Variables en la tabla de resultados del experimento 7, “Modelo 
Susceptible-Infectado-Recuperado con nacimientos” 


Variable Descripción Unidades 
S.día Días 
S.S.pob Individuos 
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S.Lpob Individuos 


S.R.pob Individuos 


Planta de experimentación 8: Modelo Susceptible-Infectado- 
Susceptible. 


Presentación: modelo de propagación de una enfermedad con dos compar- 
timentos de individuos: susceptibles e infectados. Los individuos que se re- 
cuperan pueden volver a infectarse, y por tanto se convierten en susceptibles. 
El modelo se presenta en la sección 10.1.3. 


Instrumentación”: el modelo cuenta con 3 parámetros ajustables organiza- 
dos en 2 grupos de controles (véase tabla 10.7). Como resultado del experi- 
mento, el programa despliega: 


= 2 curvas organizadas en 1 gráfico (véase tabla 10.8). 
= Una tabla de datos del comportamiento de 3 variables (véase tabla 


10.9). 


Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 8.1: Estado estacionario. 


¿Qué factores inciden en los tamaños de las poblaciones cuando se es- 
tabiliza el comportamiento? Explore cómo afectan los parámetros del 
modelo a los valores finales de las poblaciones susceptibles, infectadas y 
recuperadas. 


Experimento 8.2: Tiempos de respuesta. 


¿Qué factores inciden en la rapidez con que se estabiliza el comportamien- 
to? Explore cómo afectan los parámetros del modelo a los tiempos en que 
se alcanzan los valores finales de las poblaciones susceptibles, infectadas y 
recuperadas. 
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Experimento 8.3: Nacimientos y muertes. 


¿Cómo se comportaría el modelo si se incluyen nacimientos y muertes? 
Modifique el modelo para incorporar los fenómenos de nacimiento y 


muerte. Formule las ecuaciones que describen el nuevo modelo y com- 
párelas con las del modelo original. 


Tabla 10.7 Parámetros del experimento 8, “Modelo Susceptible-Infectado-Susceptible” 


Título: Modelo SIS 
Descripción: Modelo de propagación de una enfermedad con dos compartimentos 
de individuos: Susceptibles, Infectados. Los individuos que se recuperan 
pueden volver a infectarse, y por tanto se convierten en susceptibles. 
Implementación 
Créditos e-mail 
Parámetros 
Grupo Nombre Modelica Nombre Descripción 
beta Tasa de contagio Probabilidad de contagio cuando 
Enfermedad hay un contacto 
trec Tiempo de recuperación Número de días que tarda en recupe- 
rarse un infectado 
Poblaciones NI Infectados iniciales Número de individuos infectados al 
inicio de la simulación 
Tabla 10.8 Figuras del experimento 8, “Modelo Susceptible-Infectado-Susceptible” 
A 


Poblaciones 


Susceptbles : (Individuos) vs (días) 
Infectados : (Individuos) vs (días) 


Poblaciones 

Curva Descripción x Y 
Susceptibles eos día S.pob 
Infectados aleron de día I.pob 


La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 
hay datos tanto en español como en inglés. 
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Tabla 10.9 Variables en la tabla de resultados del experimento 8, “Modelo 
Susceptible-Infectado-Susceptible” 


Variable Descripción Unidades 
Día Días 

S.pob Individuos 
Ipob Individuos 


Planta de experimentación 9: Modelo SIR para humanos y SI con dos 
cepas para mosquito. 


Presentación: modelo de propagación de una enfermedad en el que hay dos 
cepas del virus. Los humanos recuperados de la infección de una cepa pue- 
den reinfectarse con la otra. El modelo se presenta en la sección 10.1.5. 


Instrumentación: el modelo cuenta con 11 parámetros ajustables organiza- 
dos en 2 grupos de controles (véase tabla 10.10). Como resultado del expe- 
rimento, el programa despliega: 


= 11 curvas organizadas en 4 gráficos (véase tabla 10.11). 
= Una tabla de datos del comportamiento de 12 variables (véase tabla 


10.12). 


Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 9.1: Tiempos de vida. 


¿Qué incidencia tienen los tiempos de vida media de humanos y mosqui- 
tos en el comportamiento de la epidemia? Explore cómo afecta la modifi- 
cación de los tiempos de vida de humanos y mosquitos en los diferentes 
aspectos del comportamiento de la epidemia. 
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Experimento 9.2: Poblaciones iniciales. 


¿Qué efecto tiene el tamaño de las poblaciones iniciales infectadas de hu- 
manos y mosquitos en la evolución de la epidemia? Explore cómo afecta 
el tamaño de las poblaciones iniciales infectadas de humanos y mosquitos 
los diferentes aspectos del comportamiento de la epidemia. 


Experimento 9.3: Infección máxima. 


¿Qué condiciones favorecen la propagación de la infección? Explore los 
factores del modelo que hacen que el número de infectados sea mayor, 
para cada uno de los dos serotipos. 


Experimento 9.4: Entrada del serotipo 2. 


¿Qué efecto tiene la entrada del serotipo 2 sobre la infección del serotipo 
1? Explore cómo incide la aparición del segundo serotipo en la propa- 
gación de la infección del primero. Para ello, puede modificar el día de 
entrada del segundo serotipo 


Experimento 9.5: Modelo del dengue. 


Construya un modelo del dengue El archivo dengue.mo que se encuentra 
con el código fuente de la planta de experimentación contiene un mo- 
delo del dengue (Camargo G. “Modelamiento de la dinámica del dengue 
en Colombia” Tesis de Maestría. Universidad Nacional de Colombia, 
2012). Utilice ese modelo para explorar la sensibilidad del modelo a los 
diferentes parámetros 


382 


EVOLUCIÓN DE ENFERMEDADES 


Experimento 9.6: Una única cepa. 


¿En qué difiere la propagación de la enfermedad entre los casos de una y 
dos cepas? Implemente el modelo de una única cepa y compare el com- 


portamiento de los dos casos. 


Tabla 10.10 Parámetros del experimento 9, “Modelo SIR para humanos y SI con dos cepas para 


mosquito” 
Título: Modelo SIR-SI con dos cepas 
Descripción: Modelo de propagación de una enfermedad en el que hay dos cepas del 
virus. Los humanos recuperados de la infección de una cepa pueden 
reinfectarse con la otra. 
Implementación 
Créditos e-mail 
Parámetros 
Grupo Nombre Modelica Nombre Descripción 
db Tasa de picadura Tasa de picadura ante contacto 
entre humano y mosquito 
H.ph Probabilidad de contagio del | Probabilidad de contagio ante pi- 
Enfermedad humano cadura 
V.pu Probabilidad de contagio del | Probabilidad de contagio ante pi- 
vector cadura 
H.trec Tiempo de recuperación Número de días de recuperación 
de la enfermedad 
V.tvida Días de vida del mosquito Número de días de vida del mos- 
quito 
H.tvida Años de vida del humano Número de años de vida de los 
humanos 
to2 Día de entrada del serotipo 2 Día en que aparece el primer mos- 
quito del serotipo 2 
Poblaciones V.NIvl1 Número inicial de mosquitos Número de mosquitos infectados 
infectados con el serotipo 1 al inicio de la si- 
mulación 
V.NIv2 Número inicial de mosquitos | Número de mosquitos infectados 
con serotipo 2 con el serotipo 2 al inicio de la si- 
mulación 
H.Nih1 Número inicial de humanos | Número de humanos infectados 
infectados con el serotipo 1 al inicio de la si- 
mulación 
H.Nih2 Número inicial de humanos | Número de humanos infectados 
infectados con serotipo 2 con el serotipo 2 al inicio de la si- 
mulación 


5La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 
hay datos tanto en español como en inglés. 
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Tabla 10.11 Figuras del experimento 9, “Modelo SIR para humanos y SI con dos cepas para mosquito” 


Infectados 


intectadó Seroúpo 1: (INAIVIUUOS) VS ¡alas 
Infectado serotipo 2 : (Individuos) vs (días) 
Reinfectados serotipo 1 : (Individuos) vs (días) 
Reinfectados serotipo 2 : (Individuos) vs (días) 


Recuperados 


Recuperados Serotipó 1 > (Individuos) iS (días) 
Recuperados serotipo 2 : (Individuos) vs (días) 
Recuperados : (Individuos) vs (días) 


Susceptibles 


Susceptibles : IRIMIdUOS) vs (días) 


Infectados 
Curva Descripción z Y 
Infectado learn del Oran | H.Ihl. 
ñ de infectados del seroti- | día 
serotipo 1 pob 
pol 
Infectado on ca A | H.Ih2. 
ñ de infectados del seroti- | día 
serotipo 2 pob 
po2 
Evolución del número 
Reinfectados ds ados 7 2 ¿| H.Ih21 
serotipo 1 tipo 1 (previamente in- | día pob 
fectados con el serotipo 
2 y recuperados) 
Evolución del número 
Reinfectados de reinfectados del SerO” E H.Ih12. 
divo 2 tipo 2 (previamente in- | día ob 
Soup fectados con el serotipo P 
1 y recuperados) 
Recuperados 
Curva Descripción z 7) 
Recuperados Evoluci e del número ; H.Rh1 
tipo 1 de individuos recupera- | día b 
Seronpo dos del serotipo 1 po 
Recuperados Evoluci sn del número ; H.Rh2 
tipo 2 de individuos recupera- | día b 
Seronpo dos del serotipo 2 po 
Evolución del número 
Laa > H.Rh. 
Recuperados | de individuos recupera- | día ob 
dos del ambos serotipo P 
Susceptibles 
Curva Descripción zx Y 
Evolución del número 
; E z H.Sh. 
Susceptibles | de humanos suscepti- | día pal 


bles 
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Tabla 10.12 Variables en la tabla de resultados del experimento 9, “Modelo SIR para humanos y SI con 


dos cepas para mosquito” 


Vectores 
r 
Curva Descripción zx Y 
Evolución del número 
susceptibles | de mosquitos suscep- | día | V.Sv.pob 
tibles 
Evolución del núme- 

24 ; Ñ % V.Ivl. 
susceptibles : (Individuos) vs (dlas) Serotipo 1 ro de mosquitos conel | día 3h 
Serotipo 1 : (Individuos) vs (días) serotipo 1 P 
Serotipo 2 : (Individuos) vs (días) 

Evolución del núme- 
y a P V.Iv2. 
Serotipo 2 ro de mosquitos con el día ób 
serotipo 2 P 


Variable Descripción Unidades 
Día Días 
H.Ih1.pob Individuos 
H.Ih2.pob Individuos 
H.Ih21.pob Individuos 
H.Ih12.pob Individuos 
H.Rh1.pob Individuos 
H.Rh2.pob Individuos 
H.Rh.pob Individuos 
H.Sh.pob Individuos 
V.Sv.pob Individuos 
V.Iv1.pob Individuos 
V.Iv2.pob Individuos 


10.3 LA IMPLEMENTACIÓN 


La implementación del modelo utiliza la librería de bloques Modelica Stan- 
dard Library. Se definen dos clases principales: compartimento e 
interaccion. 


= class compartimento: esta clase implementa la ecuación 10.1, ha- 
ciendo explícitos los fenómenos de nacimiento y muerte. Para ello 
se utilizan dos vectores de objetos de la clase interacción, que mode- 
lan el conjunto de entradas y salidas de individuos al compartimento, 
respectivamente. 


Las variables pertenecientes a la clase compartimento son: 
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+ pob: representa el número de individuos en el compartimento, es 
decir, su población. 


* nace: representa el número de nacimientos en el compartimento. 


+ muere: representa el número de muertes de individuos del 
compartimento. 


+ entra: vector de objetos dela clase interaccion, querepresenta los 
fenómenos por los que aumenta la población del compartimento. 


+ sale: vector de objetos de la clase interaccion, que representa los 
fenómenos por los que disminuye la población del compartimento. 


+ N: variable de la población total de la especie del compartimento. Es 
una variable de tipo outer porque la población total de la especie 
es externa al compartimento. 


Los parámetros pertenecientes a la clase compartimento son: 


+. natalidad: tasa de natalidad. 
+ mortalidad: tasa de mortalidad. 
+ nentra: número de interacciones en el vector entra. 


*« nsale: número de interacciones en el vector sale. 


Las ecuaciones básicas implementadas son las siguientes: 


dyo = NV nentra £NTra — Y nsqje SALE + nace — muere 
nace = natalidad x N (10.8) 
muere = mortalidad x pob 


class interaccion: esta clase modela el contacto entre dos especies. 
Es una extensión de un bloque general MISO con entradas 21, 19,..., 
Lnin y Salida y. La salida y se calcula como 
nin 
y = coeficiente * Il Zi (10.9) 
i=1 


En general, x, representa la población de algún compartimento. Por ejem- 
plo, el número de contagios de una especie a otra es proporcional al nú- 
mero de veces que se encuentran dos individuos de esas especies; en esta 
situación, existirán dos entradas (nin = 2), cada una de las cuales será la 
población de cada especie, y el coeficiente representará la probabilidad 
de contagio. 
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10.3.1 Ejemplo: implementación del modelo SIR 


El modelo SIR (sección 10.1.1) emplea tres compartimientos denominados S, 
I, y R (susceptibles, infectados y recuperados, respectivamente) y dos inter- 
acciones denominadas /1 e 12. 

La interacción 11 representa la infección de individuos susceptibles, y co- 
rresponde al término 551 de la ecuación 10.2. Esta interacción tiene entonces 
dos entradas, correspondientes a las poblaciones de los compartimientos S e 
[, y su coeficiente corresponde a la tasa de contagio 6. 

La interacción /2 representa la recuperación de individuos infectados, y 
corresponde al término y/ de la ecuación 10.2. Esta interacción tiene entonces 
una entrada, correspondiente a la población del /, y su coeficiente corresponde 
a la tasa de recuperación 7. 

Las poblaciones iniciales de los tres compartimientos se han modelado 
con los parámetros NS, NI, y NR. La implementación total del modelo se 
encuentra en el archivo SIR.mo. 


10.3.2 Listado de archivos 


La tabla 10.13 muestra el listado de los archivos fuente de la implementación 
del modelo. 


Tabla 10.13 Archivos del modelo 


Número Archivo 

10.1 SIR.mo 

10.2 SIRn.mo 

10.3 SIS.mo 

10.4 compartimento.mo 
10.5 dengue.mo 

10.6 dosserotipos.mo 
10.7 humano.mo 
10.8 interaccion.mo 
10.9 package.mo 
10.10 vector.mo 
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Archivo 10.1 SIR.mo 


Archivo 10.2 SIRn.mo 


Archivo 10.3 SIS.mo 


EVOLUCIÓN DE ENFERMEDADES 


Archivo 10.4 compartimento.mo 


Archivo 10.5 dengue.mo 
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Archivo 10.6 dosserotipos.mo 


Archivo 10.7 humano.mo 
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Archivo 10.8 interaccion.mo 


Archivo 10.9 package.mo 


Archivo 10.10 vector.mo 
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TRÁNSITO DE ESTUDIANTES A TRAVÉS DE 
UN PLAN DE ESTUDIOS 


El modelo representa el flujo de estudiantes a través de un plan 
de estudios de un programa universitario. El modelo permite es- 
timar el número de estudiantes en cada periodo académico, el 
número total de estudiantes, el número de graduados y el tiem- 
po medio de graduación. 


El número de estudiantes inscritos en un plan 
de estudios universitario depende de factores 
tales como el flujo de inscripción, las tasas de 
aprobación de asignaturas, la estructura curri- 
cular del plan, etc. Para la institución universi- 
taria es necesario estimar la forma como evolu- 
ciona el número de estudiantes, para así poder 
prever los recursos mínimos que se deben pro- de inccsieosenla Uelcradad 

veer para atender la demanda académica deesa nacional de Colombia. Año 1964! 
población estudiantil. 


Figura 11.1 Ceremonia de graduación 


Tomada de [link:14]. 
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El modelo que se presenta parte de una simplificación de los planes de 
estudio reales. A partir de allí, se formula una colección de ecuaciones de dife- 
rencia que derivan en un modelo dinámico lineal. El análisis matemático del 
modelo permite inferir el efecto que tienen algunos fenómenos sobre el nú- 
mero de estudiantes y el tiempo medio de graduación. El modelo se presenta 
de forma extensa y aplicada al caso particular de la Facultad de Ingeniería de 
la Universidad Nacional de Colombia en [Dua13]. Para comodidad del lector, 
se reproducen en la sección 11.1 los principales elementos matemáticos del 
modelo. 


11.1 EL MODELO 


Un plan de estudios típico de un programa universitario cuenta con una colec- 
ción de asignaturas, entre obligatorias y electivas, que se distribuyen a lo largo 
de varios periodos académicos. A manera de ejemplo, los planes de estudio de 
la Facultad de Ingeniería en la Universidad Nacional constan de cerca de 60 
asignaturas, distribuidas a lo largo de 10 semestres académicos. 

La figura 11.2 muestra una versión simplificada de un plan de estudios. 
Se trata de un plan de estudios de n periodos académicos, con una única asig- 
natura en cada semestre, que es prerrequisito de la asignatura del siguiente 
semestre. Con este modelo simplificado se pueden representar varios fenó- 
menos asociados al tránsito de los estudiantes a través del plan de estudios. 


Semestre 1 Semestre 2 Semestre n 


Asignatura 1 Asignatura 2 


Figura 11.2 Plan de estudios del modelo mínimo 
Para ello, se formula el siguiente comportamiento dinámico (D), que se 
ilustra en la figura 11.3: 


D 1. Se utiliza el subíndice j para diferenciar cada una de las n asignaturas del 
plan de estudios. Debido a que en cada semestre hay una única asigna- 
tura, el subíndice j también sirve para identificar el semestre. 


D 2. Se utiliza la variable k para referirse al periodo académico. k es una va- 
riable discreta que puede asimilarse a la secuencia de periodos (p. ej., 
“2009-01; 2009-03; “2010-01; etc.) o a los enteros (k = 1,2,---). 


D 3. El número de estudiantes que inscriben la asignatura ¡ en el periodo aca- 
démico k se denota por x;(k). 
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gepitenc,, 


Figura 11.3 Diagrama de flujo para el estado x:; (k) 


D 4. Al pasar de un periodo académico al siguiente, algunos estudiantes pasan 
a la asignatura del semestre posterior; algunos no lo logran, bien porque 
cancelan o porque no aprueban (véase figura 11.3): 


Uj+i(k +1) = Lap, (k) + Teanjy1 (K) + Tnapyy1 () +t5(k) (111) 
en donde: 
= Zap, (k): número de estudiantes que aprobaron la asignatura ¡ en el 


periodo k. 


" Zeanj+ (k): número de estudiantes que cancelaron la asignatura ¡+ 
1 en el periodo k. 


= Tnap;+1 (%): número de estudiantes que inscribieron y que no cance- 
laron ni aprobaron la asignatura j +1 en el periodo k y que tampoco 
perdieron la calidad de estudiante. 


= t;(k): número de estudiantes que ingresan al programa por trasla- 
do o por autorización de doble titulación. Estos estudiantes inician 
estudios en el periodo (k + 1), inscribiendo la asignatura j. 


D 5. Para el semestre 1 la dinámica se representa por: 
ae =toa ld) Fra FU (11.2) 
En donde 


= u(%): Número de admitidos en el periodo k que inician estudios en 
el periodo (k + 1). 
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D6. 


D7. 


Dg. 


DO. 


Se definen los siguientes parámetros: 


= Q(k): tasa de aprobación para la asignatura ¿ en el periodo k. 

= P;(k): tasa de cancelación para la asignatura ¡ en el periodo k. 

= 0j(k):tasa de pérdida de calidad de estudiante para el semestre j en 
el periodo k. 


Los términos de la derecha en la ecuación 11.1 pueden entonces calcu- 
larse asi: 


= 25()01 — B5())05(%) 4 — 0741()) 
Ccanj+1 (%) —= Ij4+1 1(k)Bj41 (k Ja = 0j+1(k)) 


jaa Bra) A — aj) 0 — 0341(k)) 
(11.3) 


Se denota por y;(k) al número de estudiantes que inscriben una asigna- 
tura de un semestre menor o igual a j en el periodo k. 


Se denota por yr(k) al número total de estudiantes del programa en 
el periodo k, es decir yr (k) = yn (k). 


D 10. Se denota por g(k) al número de estudiantes graduados al terminar 


el periodo académico k. 


Con esas condiciones, se puede derivar un modelo dinámico discreto li- 


neal variante en el tiempo. A partir de las ecuaciones 11.1 y 11.3 se obtiene un 
conjunto de ecuaciones válidas para ¿ =1,2,---,n— 1: 


xjy1(k +1) = Tap, (k) + Teanjy1 (k) + Tnap¡+1 (4) a t;(k) 


Para el primer semestre se emplea la ecuación 11.2: 
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El conjunto extendido de ecuaciones resulta ser 


a (+1) =01(k)816) 0 — 01(k))+ 


a(k)01— BY) — a) 0 — o1())+ 
u(k) + t1(k) 


t2(k +1) =x1(k)(1 — Br(k))J01() (1 — 02(k))+ 

22(k)B2(k)(1 — o2(k))+ 

22(k) (1 — Pa())(1 — a2())(1 — 02(k))+ 
t2(k) 

23(k +1) =x2(k) (1 — P2(k))a2(k) (1 — 03(k))+ 
23()B3(k)(1 — 03(k))+ 
23(k)(1 — Pa(x))(1 — az(k))(1 — 03(k))+ 


k 
talk) (11.4) 


Tp (k +1) =2p-1(k) (1 — Br-1(%))0m-1(%) (1 — on (k))+ 
Un(k)Bn(k) 0 — on(k))+ 
Un(k)0 — Bník))(1 — an(k))(1 — on(k))+ 
tn(k) 
y1(k) =x1(k) 
y2a(k) =x1(k) + z2(k) 


Yn[k) =x1(k) + 22(k) + u3(k) +++ +un(k) 
g(k) =(1 — Bntk))an(k)( — on(k))2n(k) 
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Las ecuaciones en 11.4 pueden escribirse de forma más compacta. Para 
ello definimos: 


yj(k) = 1 — By(k))as(k) (1 — 05(k)) das 
9(k) = Bi(k) (1 — 0,(k)) + A — Bj(x))0 — ajz(k)) (1 — 0(k)) 
en cuyo caso 
ale + 1) =w ol) + u(k) + t1(k) 
Ta(k +1) =x1(k)y1(k) + 22(k)ó2(k) + ta(k) 


T3(k +1) =x2(k)y2(k) + 23(k)ó2(k) + t3(k) 


En(k +1) =2n-1(k)1m-1(k) + En(k)ón(k) + tn(k) 
y1(k) =x1(k) 


ya(k) =u1(k) + 22(k) 


(11.6) 


Yn[(k) =x01(k) + 22%) + c3(k) +++ +un(k) 


g(k) =p (k) 


La ecuación 11.7 presenta el modelo en forma matricial: 
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X(k +1) = A(k)X(k) + B()U(k) 


d1(k) 0 
mí)  da(k) 
A(k)=| 0 mix) 
0 0 
h 
0 
[3mm]B(k) = |0 
[0 
h 1 1 1 
0 1 1 yl 
0 0 1 1 
C(k) = 
0.000 1 
[o 0.0 Im(k) 
x1(k) 
xa(k) 
X()=| Y (k) = 
2n(k) nxl 


Y (k) = C()X (4) + D(k)U(k) 


0 0 0 
0 0 0 
53(k) 0 0 
o sn) 8] 
10.0 0 
0.1 0 0 
0. 0 1 0 
0.000 cid 
nx(n 
a (11.7) 
0.0 0 
0.0 0 
D(k) = 
0.0 
nx(n+1) 
a nxn _ yz - 
y1(k) u(k) 
ya(k) t1(k) 
U(x) = |to(r) 
Yn(k) 
k tnlk 
[al )] (n+1)x1 E ( )] (n+1)x1 


yi(k) = (1 By()04() (1 — 05(%)) 
67(k) = B(4)(1 


0j(k)) 


F (1 


BOYA — a ()) 11 — o (k)) 
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11.1.1 Modelo reducido 


Con el propósito de facilitar el análisis del modelo, se introducen dos 
simplificaciones: 


= Invarianza en el tiempo: todos los parámetros del modelo permanecen 
constantes a lo largo del tiempo. 


= Homogeneidad: los parámetros del modelo son iguales para las n asig- 
naturas del plan de estudios. 


Estas simplificaciones implican: 
aj(k)=a Vj,k 
Bi) =P Vj,k (11.8) 
ojlk)=0 Vj,k 
El modelo reducido resulta ser un modelo lineal invariante en el tiempo: 
X(k+1) = AX(k) + BU(k) 
Y (k) = CX(k) + DU(k) (11.9) 


Para un programa de 10 semestres, desarrollado durante 8 periodos, esta 
simplificación reduce el número de parámetros de 10 x 8 x 3 = 240 a solo 3. 
11.1.2 Análisis del modelo reducido 


Utilizando el modelo reducido, se formulan las siguientes preguntas de 
análisis (P): 


P 1. ¿Cómo evoluciona el número de estudiantes de un programa si el ingreso 
es constante? 


P 2. ¿Cuál es el número esperado de estudiantes de un programa si el ingreso 
es constante? 


P 3. ¿Qué efecto tienen los parámetros del modelo sobre el número esperado 
de estudiantes? 


P 4. ¿Cuántos estudiantes se graduarán y en qué tiempo lo harán? 


P 5. ¿Qué efecto tienen los parámetros del modelo sobre el número de gra- 
duados y los tiempos de graduación? 


Estas preguntas se abordan en las secciones siguientes. 
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11.1.3 Evolución del número de estudiantes 


Para analizar la evolución del número de estudiantes se considera el caso en 
que no hay traslados (t¿(%) = 0) y los ingresos son constantes (u(k) = u). En 
otras palabras, se realiza un análisis de respuesta a una entrada escalón en los 
ingresos. 

Si se considera como salida del sistema a yy (k) (el número total de estu- 
diantes del sistema), entonces la función de transferencia Py (z) puede defi- 
nirse como: 


La expresión de Fy (2) corresponde a (véase [Dua13]) 


1 j 
Fr(z) = A re 


j=1 


El sistema tiene un único polo Y que aparece n veces en la función de 
transferencia. La estabilidad del sistema depende entonces del valor de ó. Tanto 
a. como $ son valores en el intervalo [0, 1], por tanto 


0< y=(1-Bja <1 
0< ¿=1l1=y <1l 


Como d está en el intervalo [0, 1], el sistema es estable. En el caso frontera 
en que d = 1, el sistema será marginalmente estable. Para que esto suceda, se 
necesita que y = 0, es decir, se requiere que se satizfaga una de las siguientes 
condiciones: 


= 5 = 1, lo que significa que todos los estudiantes cancelan todas las 
asignaturas. 


= 0 =0, lo que significa que ningún estudiante aprueba asignaturas. 


11.1.3.1 Ejemplo 


Para ilustrar el comportamiento del número de estudiantes, se ha corrido el 
modelo para 10 semestres (n = 10), sin traslados (t¿(k) = 0), con un ingreso 
constante de 100 estudiantes por periodo (u(k) = u = 100) y condiciones 
iniciales nulas (x¿(0) = 0). Los parámetros del modelo se han fijado en a = 
0,85, P = 0,03 y d = 0,01. Esta simulación representa la evolución esperada 
de un programa nuevo. 
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La figura 11.4 muestra los resultados de la simulación. En la figura 11.4(a) 
se muestra cómo evoluciona el número de estudiantes inscritos en cada semes- 
tre, y la figura 11.4(b) muestra la evolución del número total de estudiantes. 
Al analizar esas figuras se encuentra lo siguiente: 


Respuesta al escalón del modelo. Variables de estado. Número de estudiantes por semestre. 
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semestre 1 
semestre 2 
semestre 3 
semestre 4 
semestre 5 
semestre 6 
semestre 7 
semestre 8 
semestre 9 
semestre 10. ———— 


(a) Número de estudiantes por semestre 


Respuesta al impulso del modelo. Número total de estudiantes 


1200 


1000 


800 


600 


400 


200 


v » o o SS xv Si ES ES 


No) 


(b) Número total de estudiantes 


Figura 11.4 Respuesta al escalón del modelo. a. = 0,85 PB = 0,03 a = 0,01 
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= El sistema se estabiliza después de aproximadamente 16 semestres. 


= El valor de estado estacionario de cada semestre es diferente, siendo ma- 
yor el de los semestres inferiores. Estas diferencias se deben a los estu- 
diantes que no alcanzan los semestres superiores debido a la pérdida de 
la calidad de estudiante. 


= Los tiempos de estabilización de cada semestre son diferentes: las cur- 
vas inician en tiempos diferentes y presentan inclinaciones diferentes, 
siendo menor la pendiente de los semestres superiores. 


11.1.4 Número esperado de estudiantes 


Para analizar el número esperado de estudiantes, se calcula el número total de 
estudiantes cuando han transcurrido muchos semestres, sin traslados (t¿(k) = 
0) y con ingresos constantes (u;(k) = u). En otras palabras, se evalúa el valor 
en estado estacionario de la variable yy (k) (véase [Dua13]) 


Yee = lim yr(k) 
k=>00 


eE — ( (E e 25)) 


11.1.4.1 Caso sin pérdida de la calidad de estudiante 


Si la única causa de pérdida de la calidad de estudiante se debe a la graduación 
(o = 0), el valor esperado del número de estudiantes debe calcularse (véase 


[Dua13]) como: 
nu nu 


1 == a 
11.1.4.2 Caso de referencia 


Un caso especial se considera: si no hay cancelaciones, ni pérdida de la cali- 
dad de estudiante, y todos los estudiantes aprueban todas las asignaturas, el 
número de estudiantes se reduce a 


Yref = Yee = NU 


11.1.5 Efecto de los parámetros sobre el número esperado de estudiantes 


Para evaluar el efecto de los parámetros del modelo sobre el número esperado 
de estudiantes, se ha considerado un programa de 10 semestres (n = 10), al 
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que ingresan 100 estudiantes cada periodo u = 100. Con esas consideraciones, 
el valor de referencia es de 1000 estudiantes (Y,+j = nu = 1000). 
Sobre ese programa base se han realizado los siguientes experimentos: 


= Caso 1: se han variado los parámetros del modelo a, P y 9, uno a la vez. 
La variación se ha hecho desde O hasta 1 y se ha calculado el número 
esperado de estudiantes. En cada caso, cuando un parámetro permanece 
constante, toma los siguientes valores: 


a=0 bB=0 o=0 


= Caso 2: se han variado los parámetros del modelo a, P y 9, uno a la vez. 
La variación se ha hecho desde O hasta 1 y se ha calculado el número 
esperado de estudiantes. En cada caso, cuando un parámetro permanece 
constante, toma los siguientes valores: 


a = 0,83 p=apL o = 0,03 


Los resultados de los experimentos se muestran en la figura 11.5. Al ana- 
lizar esas figuras se hace evidente lo siguiente: 


= El número total de estudiantes es muy sensible a las tasas de cancelación 
y de aprobación. 


= La sensibilidad del número total de estudiantes a las tasas de cancelación 
y de aprobación aumenta en el caso 1, es decir, aumenta al disminuir la 
tasa de pérdida de la calidad de estudiante. 


= La tasa de cancelación actual está cercana a 0.2. Para estos valores, la 
cancelación puede estar causando un incremento hasta del 20% en el 
número total de estudiantes. 


11.1.5.1 Valor esperado y valor de referencia 


La figura 11.5 muestra que el efecto sobre el número esperado de estudiantes 
de algunos parámetros es creciente y el de otros es decreciente. Este hecho 
genera una pregunta de análisis: ¿qué combinación de parámetros hace que el 
número esperado de estudiantes se igual el número de referencia? o lo que es 
igual, bajo qué condiciones se satisface: 


> ( E ] a 0 15)) E 
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Número total de estudiantes. Efecto de los parámetros del modelo. Caso 1 
5000 


vs. tasa de Aprobación 
vs. tasa de/cancelación 
vs. tasa de pérdida de calidad de estudiante 


4000 


3000 


2000 


1000 


0 T T T T T T T 
S S Sy > Si >? Si ES > >> S 
(a) Caso 1. 
Número total de estudiantes. Efecto de los parámetros del modelo. Caso 2 
5000 


vs. tasa de aprobación 
vs. tasa de cancelación 
vs. tasa de pérdida de calidad de estudiante 


4000 


3000 


2000 


1000 


(b) Caso 2. 


Figura 11.5 Efecto de la variación de los parámetros del modelo sobre el número esperado de estudiantes 


Para el caso en que n = 10, la combinación de parámetros resulta ser 
(véase [Dua13]) 
0/0 PB) 


a= (11.10) 
| 
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La figura 11.6 muestra la superficie tridimensional que se genera a partir 
de la ecuación 11.10: 


as 0.30 


eE 0.20 


0.05 cancelación 


Figura 11.6 Superficie de población de referencia 


11.1.6 Tiempos de graduación 


No todos los estudiantes que ingresan se gradúan; los estudiantes que se gra- 
dúan lo hacen en un número de semestres diferentes. Para explorar los tiempos 
de graduación de los estudiantes admitidos en el periodo m (que ingresan al 
programa en el periodo m + 1), se define la serie de graduación G,m(k) como 


Gmlk) = g(K)limpuiso (11.11) 
El subíndice ¿impulso denota las condiciones de respuesta al impulso: 
= Condiciones iniciales nulas: x;(0) = 0. 
= Traslados nulos : t¿(k) =0. 


= La serie de ingreso representa un impulso discreto en el periodo m: 


e 
in (11.12) 
0 sikfm 
11.1.6.1 Indicadores de los tiempos de graduación 
Utilizando la serie G,,, (k) pueden definirse varios indicadores sobre el proceso 
de graduación: 
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= Número total de graduados GT: corresponde a la suma de todos los 
términos de la serie: 


k=0 


= Tiempo medio de graduación G,,: el tiempo transcurrido entre el ingre- 
so al programa (que sucede en m + 1) y el tiempo k es (k — (m+1)) = 
(k — m — 1); por tanto, el tiempo medio de graduación se calcula: 


> _ Dgo (kh — m-— 1))Gm(k) 
Gn = 2120 a 


= Varianza en el tiempo de graduación: calculada como 


7 20 Gm(k) (En-y 


GVmn = Var[Gm(k)] GT m 


Si se considera el tiempo de graduación para una única cohorte que in- 
gresa en el periodo inicial (m = 0), entonces las expresiones para la serie de 
graduación y el tiempo medio de graduación resultan ser (véase [Dua13]): 


jala l Co DIAN 
Gol) = (a PO 


0 sik<n 
a 11.13 
Go E SÓ 


y=(11=BJa(l=0) 
$ =P(1=0)+ (1 P)1 — a) 0) 


11.1.6.2 Ejemplo 


Para ilustrar el comportamiento del número de estudiantes se ha corrido el 
modelo para 10 semestres (n = 10), sin traslados (t¿(k) = 0), con un ingreso 
constante de 100 estudiantes en el periodo inicial (u(0) = u = 100) y condi- 
ciones iniciales nulas (=¿(0) = 0). Los parámetros del modelo se han fijado 
en O = 0,85, P = 0,03 y d = 0,01. Esta simulación representa la evolución 
de una única cohorte. 

La figura 11.7 muestra los resultados de la simulación. En la figura 11.7(a) 
se muestra cómo evoluciona el número de estudiantes inscritos en cada semes- 
tre, y la figura 11.7(b) muestra la evolución del número total de estudiantes. 
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100 


Respuesta al impulso del modelo. Variables de estado. Número de estudiantes por semestre 


80 


60 FP 


40 P 


20 


semestre 1 
semestre 2 
semestre 3 
semestre 4 
semestre 5 
semestre 6 
semestre 7 
semestre 8 
semestre 9 
semestre 10 


NN 


r > o o S] oy NS SS] ES NS 
(a) Número de estudiantes por semestre 
Respuesta al impulso del modelo. Serie de graduación 
25 
20 Pp 7 
15 |p 4 
10 FP 7 
sb J 
0 T T T T T ,S T 
nr » o > SS xy SS No ES SS 
(b) Número total de estudiantes 
Figura 11.7 Respuesta al impulso del modelo. «+ = 0,85 $ = 0,03 a = 0,01 
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Para este ejemplo, los indicadores de los tiempos de graduación toman los si- 
guientes valores: 


GTm = 88,5 
Cr= 1 
CV. =2,5 


11.1.7 Efecto de los parámetros sobre los tiempos de graduación 


Para evaluar el efecto de los parámetros del modelo sobre el número esperado 
de estudiantes, se ha considerado un programa de 10 semestres (n = 10) al que 
ingresan 100 estudiantes cada periodo u = 100. Con esas consideraciones, el 
valor de referencia es de 1000 estudiantes (y,.¿ = nu = 1000). 

Sobre ese programa base se han realizado los siguientes experimentos: 


= Caso 1: se han variado los parámetros del modelo a, P y 9, uno a la vez. 
La variación se ha hecho desde O hasta 1 y se ha calculado el tiempo 
medio de graduación. En cada caso, cuando un parámetro permanece 
constante, toma los siguientes valores: 


a=0 bB=0 o=0 


= Caso 2: se han variado los parámetros del modelo a, P y 9, uno a la vez. 
La variación se ha hecho desde O hasta 1 y se ha calculado el tiempo 
medio de graduación. En cada caso, cuando un parámetro permanece 
constante, toma los siguientes valores: 


a. = 0,83 P =0,01 o = 0,03 
Los resultados de los experimentos se muestran en la figura 11.8. Al ana- 
lizar esas figuras se encuentra lo siguiente: 


= El tiempo medio de graduación es muy sensible a las tasa de cancelación 
y de aprobación. 


= El tiempo medio de graduación no es muy sensible a la tasa de pérdida 
de calidad de estudiante. 


= La sensibilidad del número total de estudiantes a la tasa de cancelación 
y de aprobación es semejante en los dos casos. 


= La tasa de cancelación actual está cercana a 0.2. Para estos valores, la 
cancelación puede estar causando un incremento de hasta dos semestres 
en los tiempos medios de graduación. 
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Tiempos medio de graduación. Efecto de los parámetros del modelo. Caso 1 


20 
vs. tasa de aprobación 
vs. tasa de cancelación 
vs. tasa de pérdida de calidad de estudiante ———— 
18 + 7 
16 + 7] 
14 +p al 
12 t 7 
10 
T T T T T T T T T 
S Sl SS > Si > So S > > A 
(a) Caso 1. 
Tiempos medio de graduación. Efecto de los parámetros del modelo. Caso 2 
20 
vs. tasa de aprobación 
vs. tasa de cancelación 
vs. tasa de pérdida de calidad de estudiante 
18 + 7 
16 + 5 
14 +p al 
12t 7 
10 + 7 
T T T T T T T 
S > oy > Si > o S SS > S 
(b) Caso 2. 


Figura 11.8 Efecto de la variación de los parámetros del modelo sobre el tiempo medio de graduación 
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11.2 PLANTAS DE EXPERIMENTACIÓN Y EXPERIMENTOS SUGERIDOS 


Planta de experimentación 10: Respuesta al escalón. 


Presentación: esta planta implementa el modelo reducido que se explica en 
la sección 11.1.1. La planta considera un plan de estudios nuevos, es decir, 
con condiciones iniciales nulas. El ingreso de estudiantes y los traslados son 
constantes. En otras palabras, la planta permite realizar simulaciones de la 
respuesta al escalón del modelo reducido. El número de estudiantes que in- 
gresan al plan por concepto de traslados se distribuye uniformemente en 
todos los semestres. 

Instrumentación”: el modelo cuenta con 6 parámetros ajustables organiza- 
dos en 3 grupos de controles (véase tabla 11.1). Como resultado del experi- 
mento, el programa despliega: 


= 11 curvas organizadas en 2 gráficos (véase tabla 11.2). 


= Una tabla de datos del comportamiento de 12 variables (véase 
tabla 11.3). 


Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 10.1: Número estable de estudiantes. 


¿Cómo afectan los parámetros de desempeño académico el número esta- 
cionario de estudiantes? Explore el efecto que tiene la acción de modifi- 
car los parámetros de desempeño académico en el número de estudiantes 
cuando han transcurrido suficientes semestres para que se estabilice ese 
valor. 


Experimento 10.2: Tiempo de estabilización. 


¿Cómo afectan los parámetros de desempeño académico el tiempo (núme- 
ro de semestres) en que se estabiliza el número de estudiantes? Explore el 
efecto que tiene la acción de modificar los parámetros de desempeño aca- 
démico el número semestres necesarios para que se estabilice el sistema. 


413 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


Experimento 10.3: Condiciones equivalentes de referencia. 


¿Qué desempeños académicos producen una población final igual a la de 
referencia? Explore qué combinaciones de los parámetros de referencia 
hacen que el número de estudiantes sea igual al de la condición de refe- 
rencia (ingreso x número de semestres del plan de estudio). 


Experimento 10.4: Ingresos vs traslados. 


¿Tienen el mismo impacto en la población de estudiantes el aumento del 
número de ingresos que el del número de traslados? Explore y compare el 


impacto de modificar el número de ingresos y traslados sobre la población 
final y los tiempos de estabilización. 


Experimento 10.5: Poblaciones por semestre. 


¿Qué condiciones hacen que las poblaciones de los diferentes semestres 
sean más parecidas? Explore el efecto de los parámetros de desempeño 
académico, traslados e ingresos para determinar en qué condiciones es 
menor la diferencia del número de estudiantes de los diferentes semestres. 


Tabla 11.1 Parámetros del experimento 10, “Respuesta al escalón” 


Título: Ingreso constante 
Descripción: Evolución del número de estudiantes de un programa curricular, con 
ingreso constante de estudiantes al primer semestre 
Implementación 
Créditos e-mail 
Parámetros 
Grupo Nombre Modelica Nombre Descripción 


2La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 
hay datos tanto en español como en inglés. 
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aprobacion Aprobación Tasa de aprobación de las asignaturas 
Rendimiento cancelacion Cancelación Tasa de cancelación de asignaturas 
perdidacalidad Deserción Tasa de pérdida de la calidad de estu- 
diante 
lan d di ingreso Ingreso Número de estudiantes que ingresan a 
Plan de estudios primer semestre 
traslado Traslados Número de traslados desde otras carre- 
ras. Se distribuyen homogéneamente en 
todos los semestres 
Parámetros de simulación stopTime Semestres Número de semestres simulados 


Tabla 11.2 Figuras del experimento 10, Respuesta al escalón” 


Total de estudiantes 


Estudiantes : (estudiantes) vs (semestres) 


Estudiantes por semestre 


SDEmMeSIB Ir. 
Semestre 2 
Semestre 3 
Semestre 4 
Semestre 5 
Semestre 6 


¡estútianiés) vs ¡sémésues) 
z festudiantes) vs (semestres) 
: (estudiantes) vs (semestres) 
: (estudiantes) vs (semestres) 
e lesiuaieniaa! vs (semestres) 
(estudiantes (semestres) 


Total de estudiantes 


Curva 


Descripción z Y 


Estudiantes 


Número total de estudian- 


todos 
tes en el programa 


sem 


Estudiantes por semestre 


Curva Descripción T Y 
Número de estudiantes del 

Semestre 1 sem sl 
semestre 1 
Número de estudiantes del 

Semestre 2 sem s2 
semestre 2 
Número de estudiantes del 

Semestre 3 sem s3 
semestre 3 
Número de estudiantes del 

Semestre 4 sem sá 
semestre 4 
Número de estudiantes del 

Semestre 5 sem s5 
semestre 5 
Número de estudiantes del 

Semestre 6 sem só 
semestre 6 
Número de estudiantes del 

Semestre 7 sem s7 
semestre 7 
Número de estudiantes del 

Semestre 8 sem s8 
semestre 8 
Número de estudiantes del 

Semestre 9 sem s9 
semestre 9 
Número de estudiantes del 

Semestre 10 sem s10 
semestre 10 
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Tabla 11.3 Variables en la tabla de resultados del experimento 10, “Respuesta al escalón” 


Variable Descripción Unidades 

sem semestres 

todos estudiantes 
sl estudiantes 
s2 estudiantes 
s3 estudiantes 
sá estudiantes 
s5 estudiantes 
só estudiantes 
s7 estudiantes 
s8 estudiantes 
s9 estudiantes 
s10 estudiantes 


Planta de experimentación 11: Respuesta al impulso. 


Presentación: esta planta implementa el modelo reducido que se explica en 
la sección 11.1.1. La planta considera un plan de estudios nuevos al que in- 
gresa una única cohorte. En otras palabras, la planta permite realizar simu- 
laciones de la respuesta al impulso del modelo reducido. El número de estu- 
diantes que ingresan al plan por concepto de traslados se distribuye unifor- 
memente en todos los semestres. 

El tiempo medio de graduación se calcula recursivamente. La gráfica 
respectiva permite véase la evolución de la recursividad. El tiempo medio de 
graduación Go, definido en la sección 11.1.6.1 es el valor estacionario de esa 
evolución. 


Instrumentación”: el modelo cuenta con 6 parámetros ajustables organiza- 
dos en 3 grupos de controles (véase tabla 11.4). Como resultado del experi- 
mento, el programa despliega: 


= 3 curvas organizadas en 2 gráficos (véase tabla 11.5). 


= Una tabla de datos del comportamiento de 4 variables (véase tabla 
11.6). 
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Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 11.1: Tiempo medio de graduación. 


¿Cómo afectan los parámetros de desempeño académico el tiempo me- 
dio de graduación? Explore el efecto que tiene la acción de modificar los 
parámetros de desempeño académico en el tiempo medio de graduación. 


Experimento 11.2: Dispersión del tiempo de graduación. 


¿Cómo afectan los parámetros de desempeño académico la dispersión del 
tiempo medio de graduación? Explore el efecto que tiene la acción de mo- 
dificar los parámetros de desempeño académico en la dispersión del tiem- 
po medio de graduación. 


Experimento 11.3: Tasa de graduación. 


¿De qué depende la tasas de graduación? Explore el efecto de los paráme- 
tros del desempeño académico en el número total de graduados. 


Experimento 11.4: Traslados. 


¿Qué efecto tienen los traslados sobre la graduación? Explore el impacto 
de los traslados sobre el tiempo medio de graduación, la dispersión del 
tiempo de graduación y el número total de graduados. Compare su im- 
pacto con el de los ingresos. 
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Experimento 11.5: Condiciones equivalentes de referencia. 


¿Las condiciones equivalentes de referencia implican graduaciones equi- 
valentes? Explore si las combinaciones de parámetros que generan po- 


blaciones iguales a las de referencia tienen condiciones de graduación 
también equivalentes a las de la situación de referencia. 


Tabla 11.4 Parámetros del experimento 11, Respuesta al impulso” 


Título: Una cohorte 
Descripción: Evolución del número de estudiantes de un única cohorte en un progra- 
ma curricular. 
Implementación 
Créditos e-mail 
Parámetros 
Grupo Nombre Modelica | Nombre Descripción 
aprobacion Aprobación Tasa de aprobación de las asignaturas 
Rendimiento cancelacion Cancelación Tasa de cancelación de asignaturas 
perdidacalidad | Deserción Tasa de pérdida de la calidad de estudiante 
land di ingreso Ingreso Número de estudiantes que ingresan a pri- 
Plan de estudios mersemestre 
traslado Traslados Número de traslados desde otras carreras. 
Se distribuyen homogéneamente en todos 
los semestres 
Parámetros de simulación stopTime Semestres Número de semestres simulados 


Tabla 11.5 Figuras del experimento 11, Respuesta al impulso” 


rr 
Graduados 
Graduados 
Curva Descripción z Y 
Número total de es- 
Graduados tudiantes en el pro- | sem | graduados 
grama 
- 2 2 Total de graduados total gradua- 
Graduados : (estudiantes) vs (semestres) Acumulados sem 
Ñ : acumulado dos 
Acumulados : (estudiantes) vs (semestres) 


3La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 
hay datos tanto en español como en inglés. 
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Tiempo medio de graduación 


Tiempo medio de graduación 


Curva Descripción T Y 
Tiempo medio de gra- tiempo 
Tmg duación sen grado 


Tmg : (semestres) vs (semestres) 


Tabla 11.6 Variables en la tabla de resultados del experimento 11, “Respuesta al impulso” 


Variable Descripción Unidades 
sem semestres 
graduados estudiantes 
total graduados estudiantes 
tiempo grado semestres 


11.3 LA IMPLEMENTACIÓN 


Las ecuaciones 11.1 y 11.3 se implementan a través de la clase asignatura, 
(véase archivo asignatura.mo). Como se trata de una ecuación de diferencias, 
se hace uso de la estructura when del lenguaje Modelica para su implementa- 
ción. 

La clase plan (véase archivo plan.mo) implementa el plan de estudios 
completo. Para ello se construye un vector de objetos de la clase asignatura. 
Estos objetos están conectados entre sí, de tal manera que el número de estu- 
diantes que aprueban la asignatura ¡ en el periodo k se iguala al número de 
los que pasan a la asignatura j + 1 en el periodo k + 1. 

En la clase plan se ha supuesto que los parámetros de todas las asigna- 
turas son iguales, lo que implica que se ha realizado una implementación del 
modelo reducido (véase sección 11.1.1). No obstante, si se desea utilizar el mo- 
delo detallado, basta con asignar los parámetros específicos a cada asignatura 
y, eventualmente, modificarlos a lo largo de la simulación, si es que estos no 
son constantes. 

Las simulaciones de respuesta al escalón y respuesta al impulso se han 
realizado a través de las clases ingresoConstante y ingresoPulso, respec- 
tivamente (en los archivos ingresoConstante.mo e ingresoPulso.mo). 
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11.3.1 Listado de archivos 


La tabla 11.7 muestra el listado de los archivos fuente de la implementación 
del modelo. 


Tabla 11.7 Archivos del modelo 


Número Archivo 

11.1 asignatura.mo 

11.2 ingresoConstante.mo 
11.3 ingresoPulso.mo 
11.4 package.mo 

11.5 plan.mo 


Archivo 11.1 asignatura.mo 
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Archivo 11.2 ingresoConstante.mo 


Archivo 11.3 ingresoPulso.mo 


Archivo 11.4 package.mo 


Archivo 11.5 plan.mo 
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12 


CENTRAL DE GENERACIÓN 
HIDROELÉCTRICA 


Se presenta un modelo de una central de generación hidroeléctri- 
ca con una carga eléctrica acoplada. El modelo incluye el control 
primario (control de frecuencia) mediante un controlador de ti- 
po Proporcional-Integral (PD), asícomo la variación del volumen 
del embalse asociado. 


La obtención de grandes cantidades de ener- 
gía eléctrica se realiza mediante la transforma- 
ción de otras formas de energía. Una de las 
formas de energía que se utilizan para ello es la 
energía potencial gravitacional de grandes ma- 
sas de agua. El proceso de transformación se 
lleva a cabo en las centrales hidroeléctricas de 
gener ación. Figura 12.1 Central hidroeléctrica 
En estas centrales se utilizan máquinas sin-  4e Cheoah en Carolina del Norte, 
crónicas que generan una diferencia de potencial e 
eléctrico con forma sinusoidal (lo que se conoce 


Tomada de [link:15] con licencia de Creative Commons. 
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como corriente alterna). La frecuencia de esa señal sinusoidal está directamen- 
te relacionada con la velocidad de giro de la turbina que mueve la máquina 
sincrónica. 

En este modelo se implementa un modelo simplificado de una central 
hidroeléctrica, que incluye el sistema que controla la velocidad de giro de la 
turbina, y por tanto la frecuencia de la señal de potencial sinusoidal generado. 
El controlador implementado es del tipo Proporcional-Integral (PI). La cen- 
tral suministra energía a una carga eléctrica, representada por un equivalente 
simple. 


12.1 EL MODELO 


12.1.1 Estructura de una central hidroeléctrica y transformaciones 
de energía 


La figura 12.2 es un diagrama esquemático de una central hidroeléctrica ge- 
nérica?. La energía eléctrica se obtiene por transformaciones sucesivas de la 
energía primaria, como se explica a continuación: 


= Hay una masa de agua en el embalse que está a una altura superior a la 
del río. Respecto al nivel en el que está el río, esta masa de agua posee 
una energía potencial gravitacional. 


= El agua entra al canal a través de la bocatoma y se desplaza a través del 
ducto en dirección a la turbina. En este proceso, la energía potencial gra- 
vitacional se transforma en energía hidráulica, gracias a la presión a la 
que está sometida el agua y a su velocidad de desplazamiento. 


= La turbina es impulsada por el agua que llega a través del ducto. En este 
proces, parte de la energía hidraúlica que transporta el agua se transfor- 
ma en energía cinética rotacional, en el conjunto turbina-generador. 


= La turbina hace girar el rotor del generador, lo que origina una diferen- 
cia de potencial entre sus terminales. Si el generador está acoplado a la 
red de transmisión, entonces circula una corriente eléctrica, y la energía 
cinética rotacional se transforma en energía eléctrica. 


= En la subestación la energía eléctrica sufre una transformación más, que 
consiste en elevar el nivel de tensión eléctrica a los valores adecuados pa- 
ra su transmisión a largas distancias. En este proceso, la energía eléctrica 


2Existe otro tipo de centrales que no utilizan embalses, sino que aprovechan caudales naturales de agua. 
Tales centrales se denominan a filo de agua y no se tratan en este documento. 
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que proviene del generador se transforma en energía eléctrica a otro ni- 
vel de tensión. 


Central hidroeléctrica 


Casa de máquinas: Subestación 


Figura 12.2 Diagrama esquemático de una central hidroeléctrica? 


12.1.2 El embalse 


El propósito del embalse es almacenar energía para utilizarla cuando se re- 
quiera. La estrategia consiste en contener una masa de agua a una altura 
superior a aquella en la que se ubica el conjunto turbina-generador. En esas 
condiciones, el agua tiene una energía potencial gravitacional que se puede 
mantener almacenada. 


12.1.2.1 Volumen de agua 


El volumen de agua almacenado V, puede calcularse en función de la altura 
del nivel de agua del embalse como 


V(h) = / " A(h)dh 


Supóngase que la forma del embalse es la de un tronco de pirámide inver- 
tida con sección transversal cuadrada. El lado x(h) puede calcularse como 


x(h) = min + A(h — himin) 


3 Adaptada de [link:16] con licencia de Creative Commons. 
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en donde a: depende de la geometría del embalse: 


a Tmaz — Umin 
hmazx E Amin 


En esas condiciones A(h) = 2?(h) y por tanto 


h h 
V(h) = Al 22(h)dh = / [(Emin + A(h — hanin))?) dh 


min min 


Efectuando un cambio de variable: 


sis. «Med 
pS h = = 
V(h) = / [(Smin + añ)? dh 
0 


h 
V(h) = / (7. + DatminH+ o2h2) dh 
0 


2 
0 
pS cla a 0? - 
V(h) = Uininh + AL minh? + Gh? (2.1) 


3 
Un caso particular sucede cuando el embalse tiene forma de prisma cua- 
drado. En esas condiciones el área no varía con la altura (A(4) = 4) o, lo que 
es igual, a. =0 .. V(h) = 22, h. 


12.1.2.2 Variación de la altura de agua 


El caudal neto (Q(t) es la velocidad con que varía el volumen del agua 
almacenada: aV()  av(m ah 

WT Tn a 
Si la forma del embalse es de tronco de pirámide cuadrada invertida, entonces 
se puede usar la ecuación 12.1: 


- -9, dh 
Q() = (Ain + 20%minh + cn) 
dh _ Q() 

de — 12. +20tmiph +00? 


min 


Si el embalse tiene forma de prisma cuadrado, entonces Se =3 
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12.1.3 El ducto 


Se define T;,, como el tiempo que tarda la columna de agua en acelerar el agua 
que fluye en el ducto desde cero hasta la velocidad de diseño. Es posible cal- 
cular T;,, como (véanse [FCDS08, NJV12]): 


Qm 
LUm Lab? 
9H m 9H mn 


en donde L es la longitud del ducto, U,,, es la velocidad media del agua, H,,, la 
cabeza neta de presión, (2,, es el caudal medio y D es el diámetro del ducto. 

Los fenómenos dinámicos al interior del ducto se modelan a partir de la 
ecuación de continuidad y la ecuación de momento. Un modelo simplificado 
de esos fenómenos se presenta en [Pri06]: la relación entre el caudal () y la 
cabeza de presión H se modela como un sistema lineal de primer orden no 
minifase. La función de transferencia Fo (s) resulta ser: 


Q(s)  bls)  1=sTw 


H(s) a(s) 14% 


Fon(s) 


que corresponde a la siguiente relación en el dominio del tiempo 


H(t) 


Q() +75, =H(t) — a 


12.1.4 La turbina 


En [Hel11] se presenta un modelo dinámico linealizado de la turbina, que 
relaciona el caudal (, la apertura de la válvula y, la cabeza hidráulica en la 
turbina h, la velocidad de giro 1, el torque 7 y la potencia transformada p: 


(2) 
dQ =H2w+52y + 52h 


_ OT Or Or 
dr = y dy Y Sn 

— 0p Op Op 
dp = 3 w+ yy + 35h 


Sin embargo, es usual utilizar modelos estáticos mucho más simples. 
Algunos de ellos involucran la variación de la eficiencia de la turbina en 
función del punto de operación, es decir, según el caudal que recibe la turbina 
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y la velocidad de giro. Modelos aún más simplificados cercanos al punto de 
operación establecen una relación lineal estática entre el caudal q(t) y el par 
generado 7(t): 


12.1.5 El generador 


El generador es la máquina encargada de realizar la conversión de energía me- 
cánica rotacional en energía eléctrica. Típicamente se trata de una máquina 
sincrónica trifásica. A manera de ejemplo, la figura 12.3 muestra una foto de 
la casa de máquinas de la central Hoover, en Estados Unidos, y el rotor de uno 
de los generadores. 

El adjetivo sincrónico significa que la onda de tensión sinusoidal inducida 
tiene una frecuencia f., que está sincronizada con la velocidad angular n,, a 
la que rota el eje de la máquina. La relación es 


Nm P 1 
oa de = 217 EA 


en donde P es el número de polos de la máquina, f. está en medida en hertz, 
Nm en r.p.m., we en rad/s y T. en segundos. 7. es el periodo de la tensión 
inducida y we es su velocidad angular. 

¿A qué se refiere el número de polos? Usualmente, estas máquinas tienen 
el circuito de campo en el rotor y el circuito de armadura en el estator. 
La figura 12.4 muestra un diagrama de una máquina trifásica sincrónica: 
acoplado al rotor hay un devanado que cumple el papel de un electroimán 
(en la figura 12.4 se identifica con el color amarillo). El campo magnético 
creado por este circuito atraviesa tres devanados acoplados al estator (en la 
figura 12.4 se identifican con los colores rojo, azul y verde). Al girar, el flujo 
magnético que atraviesa cada uno de esos devanados varía, lo que induce 
una diferencia de potencial eléctrico entre los terminales de cada devanado. 
El mismo efecto se logra si en lugar de distribuir 3 devanados en los 360", se 
distribuyen 3P devanados (3, 6, 9, - -- devanados). P es entonces el número 
de polos con los que se ha construido la máquina. 

¿Qué significa el adjetivo trifásico? El diseño geométrico de la máquina es 
tal que, si el rotor gira a una velocidad angular constante, la tensión inducida 
en cada uno de los devanados es sinusoidal. Como los devanados están ubica- 
dos en el estator, desfasados 120? geométricos, las tensiones inducidas estarán 
desfasadas 120” eléctricos. 


f. = (12.2) 
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En, =Eacos(fet) 
Ea, = Eacos( Pet — 120%) (12.3) 


Ea, = Eacos(Het — 240”) 


3 


. 
MN 
i ! Mn 
y 


Figura 12.3 Arriba: casa de máquinas de la central asociada a la presa Hoover en Estados Unidos. Abajo: 
rotor de uno de los generadores* 
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Figura 12.4 Diagrama de una máquina sincrónica* 


El conjunto de tensiones de la ecuación 12.3 se muestra en la figura 12.5. 
Se trata de un sistema trifásico de tensiones porque tienen las siguientes 
propiedades: 


= Son tres tensiones sinusoidales. 
= La frecuencia de las tres tensiones es la misma. 
= La amplitud de las tres tensiones es la misma. 


= El desfase relativo entre las tres tensiones es de 1/3 de ciclo. 


T—— Er, —— Er —— E, 


3 


Figura 12.5 Sistema trifásico de tensiones inducidas en el circuito de armadura 


“Tomadas de [link:17] y de [link:18] con licencia de Creative Commons. 
5 Tomada de [link:19] con licencia de Creative Commons. 
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El valor de la amplitud de la tensión inducida por fase Ea es directamente 
proporcional al flujo magnético / y a la velocidad angular : 
120 
Ea = KpQNm = Kóowe K=Kr35 
27P 
en donde [y es una constante que depende de factores constructivos. Puede 
reescribirse entonces 12.3 como 


Ea, = Kquwecos(Fet) 
Ea, = Kquecos(?et — 1207) (12.4) 


Ea, = Kquecos(Set — 2407) 


3 


La figura 12.6 muestra el circuito equivalente de la máquina trifásica 
sincrónica: a la izquierda se representa el circuito de campo, que se alimen- 
ta con una fuente de tensión continua Vp. Mediante la resistencia ajustable 
Raaj se controla la cantidad de corriente que circula y, por tanto, la mag- 
nitud del flujo magnético f. A la derecha se muestran los tres circuitos 
de armadura, uno por cada fase. Las tres tensiones entre los terminales de 
armadura son V, > Vos y Vp- 


12.1.6 Los lazos de control 


Uno de los propósitos del sistema de generación es asegurar que el sistema 
trifásico de tensiones tenga una buena calidad de potencia. Esto significa, entre 
otras cosas, que las ondas generadas tengan: 


a. Una frecuencia de la onda constante. 
b. Una amplitud de tensión constante. 
En las ecuaciones 12.2 y 12.4 y se observa lo siguiente: 


= La frecuencia de la onda (w.) depende de la velocidad de giro de la tur- 
bina (nn). 


= La amplitud de la tensión (Kw) depende del flujo magnético ¿ y de la 
frecuencia de la onda (ww). 


Por esta razón, la estrategia de control usual(Ctl) de un sistema de gene- 
ración (véase figura 12.7) tiene dos componentes: 
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Ctl 1. 


Ctl 2. 
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Radj 


Ve 


Figura 12.6 Circuito equivalente de una máquina sincrónica 


Control de frecuencia: busca asegurar que la frecuencia de la onda ge- 
nerada sea constante. Para lograrlo, se utiliza un sistema de realimen- 
tación que mide la frecuencia de giro de la turbina (o la frecuencia de la 
onda generada) y corrige el par aplicado a la turbina para acelerarlo o 
frenarlo, según se requiera. En el caso de una central hidroeléctrica, el 
par se corrige abriendo o cerrando la válvula que controla el caudal que 
llega a la turbina. Este lazo de control se conoce como control primario, 
y el sistema que lo implementa se conoce como el gobernador. 


Control de tensión: busca asegurar que la amplitud de tensión sea cons- 
tante. Para lograrlo, se utiliza un sistema de realimentación que mide la 
amplitud de la tensión en los terminales de armadura y corrige la mag- 
nitud del campo magnético f para aumentarlo o disminuirlo según se 
requiera. El campo magnético se corrige controlando la tensión de ali- 
mentación del circuito de campo (Vp»). Este lazo de control se conoce 
como control secundario, y el controlador de este lazo se suele denomi- 
nar el regulador automático de tensión (Automatic Voltage Regulator 
[AVR]). 
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Sensor de 


tensión 


Válvula 


Sensor de 
frecuencia 
— Controlador 1 


Figura 12.7 Estrategia de control de generación. En rojo está el lazo de realimentación para control de 


frecuencia; en azul, el lazo de realimentación para control de tensión 


El diseño y ajuste de los dos lazos de control se realiza para condiciones 
cercanas al punto de operación, es decir, para corregir pequeñas modificacio- 
nes en la frecuencia y en la amplitud de la onda de tensión generada. Cuando 
estas variaciones no son pequeñas, se considera una condición anormal de 
operación y el sistema de protecciones (no cubierto en este documento) debe 
entrar a operar. 


12.1.7 La carga eléctrica 


En una carga eléctrica, la relación entre potencia p(t), tensión v(t) y corriente 
¿(t) es 


y el consumo de energía entre dos instantes de tiempo t: y t2 está dado por: 


e(t1,ta) = F p(tdt 


1 


En sistemas alimentados por fuentes sinusoidales de frecuencia constante 
y cargas lineales, el análisis en el dominio de la frecuencia compleja permite 
escribir 
V =ZI 
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en donde V e I son los fasores de tensión y corriente, respectivamente, y Z es 
la impedancia de la carga. Estas tres magnitudes son números complejos que 
pueden escribirse en formato polar o rectangular: 


V =VW4% =Ver+jVr 
I =10 =IrR+3l 
Z =Z4z =R+jX 


S=VI =P+j0Q 


Las cargas alimentadas por un sistema de potencia no son constantes. La 
variación del consumo de los usuarios presenta cambios fuertes a lo largo de 
un día y de un día a otro. Por otra parte, la demanda de potencia (activa y reac- 
tiva) puede verse influenciada por la variaciones de la tensión de alimentación, 
tanto en amplitud como en frecuencia. 

Para modelar estas dependencias entre la potencia demandada y la ten- 
sión de alimentación, es usual emplear dos modelos (véase [Han06])): 


a. Modelo de dependencia lineal: 


P = nominal + am AlV! + SAS 


Q =Damnal= j IMAIV] 4 SPA 


Acá, P y Q son las demandas de potencia activa e reactiva. Prominal Y 
: 9P_ 9P 9Q : 
Onominar SUS Valores nominales, av” 97? av] Y e Sus ratas de cambio 
frente a variaciones de la amplitud y frecuencia de la tensión de alimenta- 
ción, y AJV|, Af son las desviaciones de amplitud y frecuencia respecto a 


los valores nominales. 


b. Modelo de dependencia exponencial: 
pa ominall Y [PEJ2r 
Q => Onil E PE 


Acá, 
alimentación, y pu, pf, qu y q f sonlos parámetros del modelo exponencial. 
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12.2 PLANTAS DE EXPERIMENTACIÓN Y EXPERIMENTOS SUGERIDOS 


Planta de experimentación 12: Central hidroeléctrica con control PI 
de frecuencia. 


Presentación: la planta permite explorar el control de frecuencia de una 
central hidroeléctrica. Se han modelado la carga eléctrica conectada al ge- 
nerador como un valor conocido. La carga es una potencia activa que varía 
en el tiempo. 

El control de la frecuencia se obtiene mediante el control del sistema 
hidráulico que mueve la turbina. El modelo de este sistema hidráulico es el 
de un sistema dinámico no minifase de primer orden. 

El control se realiza mediante un controlador del tipo PL, que utiliza 
como referencia la frecuencia de la señal de voltaje generado. 


Instrumentación?: el modelo cuenta con 10 parámetros ajustables organi- 
zados en 3 grupos de controles (véase tabla 12.1). Como resultado del expe- 
rimento, el programa despliega: 


= 4 curvas organizadas en 4 gráficos (véase tabla 12.2). 
= 1 animación en 2D (véase tabla 12.3). 


= Una tabla de datos del comportamiento de 6 variables (véase tabla 
12.4). 


Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 12.1: Control de frecuencia. 


¿Cómo afectan los parámetros del controlador la frecuencia de la señal ge- 
nerada? Explore el impacto de los dos parámetros del controlador (ganan- 
cia proporcional k y tiempo de integración Ti) sobre el comportamiento 
de la frecuencia de la señal de voltaje generado. 
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Experimento 12.2: Efecto de la demanda. 


¿Cómo cambia el comportamiento de la planta al modificar las condicio- 
nes de potencia demandada? En el modelo implementado, la demanda 
tiene una forma trapezoidal, cuyos valores mínimo y máximo se pueden 
modificar. Explore el efecto de estos dos parámetros en el comportamien- 
to de la planta. 


Experimento 12.3: Embalse. 


¿Cuál es el efecto de los parámetros del embalse? En el modelo implemen- 
tado, el embalse tiene una sección transversal homogénea (forma de pris- 
ma). Explore cuál es el efecto de los parámetros del embalse (área, altura 
inicial, tiempo de arranque de agua), en el comportamiento de la planta. 


Experimento 12.4: Planta sin control de frecuencia. 


¿Cómo se comportaría una central hidroeléctrica sin control primario? 
Implemente un modelo de planta sin control primario, y analice su 
comportamiento. 


Experimento 12.5: Oscilaciones de frecuencia. 


¿Qué aspectos inciden en la aparición de oscilaciones de frecuencia, y en 
las características de esa oscilación? Explore bajo qué condiciones apare- 
cen oscilaciones en la señal de frecuencia, y determine las variables que 
inciden en la frecuencia y amplitud de esas oscilaciones. 
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Experimento 12.6: Planta con control proporcional. 


¿Cómo se comportaría una central hidroeléctrica con control primario 
del tipo P (proporcional)? Implemente un modelo de planta con control 


primario del tipo P (proporcional), y analice su comportamiento. 


Tabla 12.1 Parámetros del experimento 12, “Central hidroeléctrica con control PI de frecuencia” 


Título: Hidroeléctrica 
Descripción: Modelo de una central de generación hidroeléctrica con control 
primario (control de frecuencia) mediante un controlador de tipo 
Proporcional-Integral (PI) 
Implementación 
Créditos e-mail 
Parámetros 
Grupo Nombre Modeli- | Nombre Descripción 
ca 
K Proporcional Ganancia proporcional 
Controlador - 
Ti Integral Tiempo del control integral 
AreaEmbalse Área Área de la sección transversal del eme- 
balse en hectáreas (hectómetros cua- 
drados) 
Embalse yo Nivel inicial Nivel inicial del embalse en metros 
Tw Tiempo de arranque del agua Tiempo de inicio de agua 
geoFlag Perfil Perfil del embalse 
areaFactor Factor de área Relación entre área del fondo del em- 
balse y área del nivel inicial 
Operacion Carga base Referencia constante de caudal 
MinPower Mínimo Demanda de potencia mínima en MW 
Demanda - - 
MaxPower Máximo Demanda de potencia máxima en MW 


SLa información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 


hay datos tanto en español como en inglés. 
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Tabla 12.2 Figuras del experimento 12, “Central hidroeléctrica con control PI de frecuencia” 


MIEETEÉÁÉKÉKákKK KA 
Frecuencia 


Frecuencia 


Variación de la frecuencia de la señal de voltaje 
generado 


Curva Descripción z Y 


.. | Frecuencia de la señal de . 
Frecuencia a Minutos | F 
voltaje generado 


Embalse 


Nivel del agua almacenada en el embalse 


Curva Descripción z Y 
Nivel Nivel del embalse Minutos y 
Potencia 


Potencia generada 


Curva Descripción z Y 
k Potencia eléctrica ñ Generated 
Potencia Minutos 
generada Power 
r y 
Control Control 


Señal que envía el controlador PI al actuador del sistema 
hidraúlico 


Curva Descripción T Y 


9.00 12.00 1 Señal de control pa- 


Control : (-) vs (min) Control ra el actuador hi- | Minutos 
éáA2—2————————————————A draúlico 


Control 
Output 
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Tabla 12.3 Animaciones del experimento 12, “Central hidroeléctrica con control PI de frecuencia” 


V Voltaje generado 


Tensión generada 


Referencia 


Efectos 


Nombre | Descripción Tipo | Variable 


Variación del periodo 
Periodo | de la sinusoide gene- | double PeriodFactor 
rada. 


Tabla 12.4 Variables en la tabla de resultados del experimento 12, “Central hidroeléctrica con control PI 
de frecuencia” 


Variable Descripción Unidades 
minutes min 

F l/s 

y m 
GeneratedPower MW 
ControlOutput - 
PeriodFactor 


12.3 LA IMPLEMENTACIÓN 


La implementación se ha basado en la librería PoverSystems”. Esta librería 
ha sido desarrollada sobre Dymola, y no es completamente compatible con 
OpenModelica. Específicamente, la implementación es una adaptación de uno 
de los ejemplos de prueba de la librería?. Para que el ejemplo inicial pudiera 
ser compilado bajo OpenModelica fue necesario realizar las siguientes modi- 
ficaciones sobre la librería: 


1. En la línea 118 del archivo package.mo se eliminó la declaración 
replaceable del paquete PackagePhaseSystem?. 


2. En las líneas 165, 238, 303, 391 del archivo generic.mo se adicionó la 
referencia Connections a la función isRoot (terminal .theta)'. 


La figura 12.8 muestra la estructura de la implementación del archivo Hi- 
droPI.mo, que se explica a continuación: 


7 [link:20]. 
SVéase PowerSystems .Examples .PowerWorld. Test .HydroPlantTest1. 
“La instrucción resultante es package PackagePhaseSystem=. 

lL a instrucción resultante es Connections .isRoot (terminal.theta). 
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Embalse 


es 


l 


Figura 12.8 Implementación del modelo de una central hidroeléctrica con controlador de frecuencia tipo PI. En azul están los 


>| max 


parámetros ajustables de la planta en la implementación de UNVirtualLab, y en verde, las variables graficadas 


= El generador G está acoplado a una carga eléctrica L. Esta carga deman- 
da una potencia que no es constante. El generador se ha implementado 
como un objeto de la clase PoverSystems . Generic .EMF y la carga co- 
mo uno de la clase PoverSystems . Generic.PrescribedLoad. 
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= La curva de demanda de potencia se muestra en la figura 12.9. Los tiem- 
pos en los que cambia la curva están fijos (t, = 100s, to = 160s, 
tg = 460s, t4 = 7605), en tanto que los valores de potencia mínima 
y máxima pueden ser ajustados con las entradas Pinn Y Pmna- 


Pina 


Em 


ti La ta 


Figura 12.9 Curva de demanda de potencia 


= El generador también está acoplado a un momento de inercia J, que 
modela las inercias rotacionales combinadas de la turbina y el rotor del 
generador. El conjunto turbina-rotor es impulsado por un torque 7. 


= El torque 7 se ha modelado como una variable directamente proporcio- 
nal al caudal (): 
T= GQ 


= Se ha supuesto que el embalse tiene una sección transversal constante, 
es decir, que el volumen del agua acumulada puede calcularse como el 
producto de A (el área de esa sección) por la altura del nivel de agua. En 
esas condiciones, el nivel del embalse Y satisface: 
dY Q ¡e 
de TA e / A 
Por esta razón se ha utilizado un integrador para calcular el nivel del 
embalse. El integrador utiliza los parámetros ajustable A y Yo. 


= El rotor gira a una velocidad angular w. La velocidad angular se mide y 
se convierte en Hertz al multiplicarla por G¿ = 1/27. 


= El controlador PI compara la frecuencia /" con la frecuencia de re- 
ferencia F, y envía una señal al actuador del sistema hidráulico para 
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modificar el caudal. El controlador se ha implementado como un obje- 
to de la clase Modelica.Blocks.Continuous.LimPID que incorpora 
un limitador de salida y estrategias antiwindup. Los parámetros k y T; 
definen la salida C' del controlador: 


O=Ñ (6 _P+ 7 KE E Fat) 


= La respuesta del sistema hidráulico, es decir del conjunto actuador, vál- 
vula y tubería, se ha modelado como un sistema dinámico no minifase 
de primer orden (véase [Pri06])): 


Q(s) ds)  1=sT5w 


C(s) —a(s) 14 Tu 


T,, se conoce como el tiempo de arranque del agua. Este tiempo es fun- 
ción de las características geométricas de la tubería, entre otras cosas. En 
este modelo se han omitido esas relaciones. 


12.3.1 Listado de archivos 


La tabla 12.5 muestra el listado de los archivos fuente de la implementación 
del modelo. 


Tabla 12.5 Archivos del modelo 


Número Archivo 
12.1 HidroPI.mo 


Archivo 12.1 HidroPL.mo 


ES 
model HidroPI 
extends PowerSystems. Generic. Ports. PartialSource (final 
potentialReference=false); 
parameter Real primaryControlMax (unit="MW”) = 2000  ”Maximum power 
for primary frequency control”; 
Modelica. Mechanics. Rotational. Sources. Torque reservoirTurbine; 
Modelica. Mechanics. Rotational. Components. Inertia rotor(J=1e6, w(fixed 
=true, start=2x*pix*Fref)); 
PowerSystems.Generic.EMF generator(redeclare package PhaseSystem = 
PhaseSystem, definiteReference=definiteReference); 
Modelica. Mechanics. Rotational.Sensors.SpeedSensor angularVelocity; 
Modelica. Blocks .Sources. Constant reference (k=Fref); 
Modelica. Blocks. Continuous .LimPID primaryControl(controllerType= 
Modelica. Blocks. Types. SimpleController.PI, 
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13 


DINÁMICA DE SISTEMAS. MODELO DEL 


MUNDO 


El modelo corresponde a la implementación de Cellier ([Cel08]) 
del modelo de la dinámica del mundo propuesto por Meadows 
([MIM? 74]), sobre un trabajo previo de Forrester ([For71]). 


Se presenta aquí el modelo desarrollado por 
Meadows sobre la dinámica de varios facto- 
res mundiales tales como población, produc- 
ción, contaminación, etc. El modelo (que no 
está exento de controversias) utiliza la metodo- 
logía de dinámica de sistemas para representar 
las interacciones de las variables seleccionadas. 

La primera versión del modelo fue desa- 
rrollada por Forrester en el marco de la 
reunión del Club de Roma [Lan07] y publi- 
cada en 1971 (véase [For71]). Posteriormen- 
te, Meadows desarrolló una versión desarrolló 
una versión más completa del modelo en 1974 


Tomada de [link:21]; obra de dominio público. 


Figura 13.1 Model of the World and 
Gdaúsk society de Anton Móoeller 
(1563-1611)' 
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(véase [MIM*?74]) que ha tenido subsecuentes actualizaciones. En el año 2008, 
Cellier publica una librería Modelica en la que implementa la versión 2002 
del modelo (véase [Cel08]). La implementación que se presenta aquí es una 
aplicación directa de los escenarios que se encuentran en esa librería. 


13.1 EL MODELO 
13.1.1 Dinámica de sistemas 


Con el nombre de dinámica de sistemas se conoce una propuesta de mo- 
delamiento desarrollada por Forrester en los años cincuentas y sesentas. El 
nombre de por sí es controversial, debido a que se refiere solo a un tipo reduci- 
do de sistemas dinámicos y no a la generalidad que sugiere la denominación. 

La técnica de dinámica de sistemas busca el desarrollo de modelos ma- 
temáticos de sistemas a partir de un conocimiento muy limitado de su com- 
portamiento, fundamentalmente a partir de las relaciones causa-efecto (véase 
[Lan07]). Este es otro de los aspectos controversiales de la propuesta. ¿Puede 
desarrollarse un modelo dinámico veraz sin datos numéricos exahustivos? 
Para hacerlo, se utiliza una estructura versátil, pero limitada, de relaciones 
entre variables, que incluye principalmente acumuladores, lazos de realimen- 
tación, variables auxiliares, sumas, productos y funciones rectas a trazos. 

En términos generales, el comportamiento de una variable dinámica y se 


modela como 
lao 
dt 
en donde y* y y” son dos ratas de cambio de la variable y, la primera es po- 
sitiva y la segunda es negativa. Estas ratas dependen de uno o mas factores F; 


asociados a las otras variables del modelo. Por ejemplo, para y*: 
y* = f(F,, Fa,-+> , Fg) 


La limitación en la estructura de los modelos aparece en la relación que asume 
la estructura de las funciones: 


FL Pa, Fu) = fu Pi) fa(Pa) + fe(Ex) 


La principal virtud de la dinámica de sistemas es, a la vez, su punto más 
débil: brinda la posibilidad de construir un modelo matemático dinámico a 
partir de muy poco conocimiento; sin embargo, debido a la escasez de datos 
numéricos utilizados, es difícil (o imposible) realizar una validación cuantita- 
tiva, lo que le resta credibilidad al modelo resultante. 
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13.1.1.1 El proceso de modelamiento 


La técnica de modelamiento de dinámica de sistemas (DS) propone los si- 
guientes pasos (véase [Cel91]): 


DS 1. 


DS 2. 


DS 3. 


DS 4. 


Preparar la lista de lavandería: en este paso se enumera la colección de 
variables y factores que deben aparecer en el modelo. También se in- 
tenta determinar qué factores y variables influencian a cada una de las 
variables. 


Dibujar el diagrama de influencias: el listado anterior se lleva a un dia- 
grama (semejante a los diagramas de bloques o a los diagramas de flu- 
jo de señal) que ilustra las influencias que recibe cada variable. Es un 
grafo orientado (un diagrama con flechas) que además marca el senti- 
do (positivo o negativo) de cada influencia. 


Dibujar el diagrama de estructuras: el diagrama de influencias se vuelve 
a dibujar, utilizando una convención de símbolos que permite distinguir 
los tipos de variables involucradas y los tipos de relaciones entre ellas. 
Algunos de los símbolos empleados en un diagrama de estructuras se 
muestran en la figura 13.2. 


Simular el comportamiento: el diagrama de estructuras permite identi- 
ficar las relaciones matemáticas entre las variables y, por tanto, simular 
el comportamiento dinámico. Generalmente esto se hace en una misma 
herramienta de software”. 


13.1.1.2 Tipos de variables y relaciones 


Un modelo de dinámica de sistemas distingue los siguientes tipos de variables 
(véase [Ara95]): 


De nivel: son variables que representan acumulaciones de algo (energía, 
dinero, masa, etc). 


De flujo: son variables que representan variaciones de las variables 
de nivel. 


Auxiliares: son las demás variables en el modelo. 


2La herramienta más popular es STELLA (véase [sys07]). En [Cel08] se presenta la implementación en 
Modelica de la librería, que es la que aquí se ha usado. 
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Variable de nivel po] 
Variable de flujo E 


Variable auxiliar O 
Constante A 
Canal de información | 
Canal ——=> 


Canal con retardo > 
Fuente o sumidero «e 


Figura 13.2 Símbolos empleados en un diagrama de estructuras, según [Ara95] 


Las relaciones matemáticas que se establecen entre las diferentes variables 


del modelo pueden ser 
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Derivadas: en esencia, una variable de flujo es la derivada de una variable 
de nivel. 


Producto de varias variables: las variables de flujo pueden obtenerse co- 
mo producto de otras variables. 


Ganancias: una variable puede obtenerse como el producto de otra va- 
riable por un valor constante denominado ganancia. 


Funciones a trozos representadas por tablas: una variable puede obte- 
nerse transformando otra a través de una función continua a trozos. La 
forma de especificar esa función es mediante una tabla que contiene los 
puntos extremos de cada trozo, y realizando una interpolación lineal en- 
tre dichos puntos. 


Retardos: puede considerarse que la influencia de una variable en otra 
incluye retardos en el tiempo. 
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13.1.2 Modelo del mundo 
13.1.2.1 Consideraciones generales 


El modelo propuesto por Meadows en [MIM*74] es un modelo global. Se basa 
en comportamientos promedio o totales; es decir, el modelo no considera las 
diferencias e interacciones entre diferentes regiones ni grupos culturales. 

Los parámetros del modelo se basan en una amplia lista de estudios desa- 
rrollados por la comunidad académica internacional. Sobre varios de los pa- 
rámetros más importantes hay, no obstante, un gran margen de incertidum- 
bre, debido fundamentalmente a la dificultad de medir o estimar parámetros 
globales. 

La generalidad del modelo sumada a la incertidumbre en sus parámetros 
hace que las predicciones numéricas del modelo sean de dudosa exactitud. 
Los autores son conscientes de este hecho, y por ello insisten en que las simu- 
laciones no pueden considerarse como predicciones numéricas; en su lugar, 
proponen una interpretación cualitativa que permite darle una explicación a 
los comportamientos globales emergentes. 

El modelo actualizado a 2002 se presenta y analiza en [MRMO5]. En [Kim16] 
se encuentra una herramienta en línea que permite correr las simulaciones del 
modelo y sus diferentes escenarios. 

El modelo ha sido objeto de una gran controversia, sin duda alimentada 
por la popularidad alcanzada por los libros que han divulgado las conclusio- 
nes de los autores. En [dlLM12, Nor73, PM12, Rod10] se encuentran algunas 
críticas, a favor y en contra, del modelo. 


13.1.2.2 Estructura del modelo 


El modelo consta de varios submodelos fuertemente interconectados, que pue- 
den agruparse de la siguiente manera: 


a. Submodelos de la población: la figura 13.3 muestra el modelo general de la 
dinámica de la población. Pueden verse dos lazos de realimentación, uno 
positivo y otro negativo, asociados a los nacimientos y a las muertes. El 
modelo implementado es más complejo, ya que distingue cuatro franjas 
de edades: 

= Menores de 14 años. 
= Entre 14 y 44 años. 
= Entre 45 y 64 años. 
= Mayores de 64 años. 
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Nacimientos (+) (=) Muertes 


Fertilidad Mortalidad 


Figura 13.3 Dinámica general de la población 


El modelo se apoya además en la noción de transición demográfica, que 
explica las variaciones en la fertilidad y la mortalidad de acuerdo con los 
siguientes postulados: 


= En sociedades preindustriales, la fertilidad y mortalidad son altas y 
sus tasas tienen valores cercanos, razón por la cual la población crece 
lentamente. 


= Al mejorar las condiciones de salud y nutrición, disminuye la morta- 
lidad, mientras que la fertilidad tiene un rezago de dos generaciones. 
La brecha entre natalidad y mortalidad acarrea un rápido aumento de 
la población. 


= Con niveles altos de industrialización la fertilidad cae y la población 
crece lentamente. 


La fertilidad está además afectada por el control de la natalidad. Uno de 
los parámetros de control de la natalidad es el número máximo de hijos 
deseados por pareja. 


b. Submodelos de la producción industrial: estos submodelos se construyen 
bajo el concepto de economía física, en contraposición al concepto de eco- 
nomía monetaria. El primero se ocupa de la cuantificación de las cosas 
reales, mientras que el segundo se ocupa de la valoración del dinero, en- 
tendido este como una invención social. 


En el modelo se define el capital industrial como el conjunto de elementos 
de hardware (máquinas y fábricas) empleados para la fabricación de pro- 
ductos manufacturados. Por otra parte, la producción industrial se clasifica 
en diferentes tipos: 
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1. Capital de servicio: fabricación de equipo y edificios para escuelas, 
bancos, hospitales y tiendas de distribución. El capital de servicio ge- 
nera intangibles como salud y educación. 


11. Capital agrícola: fabricación de maquinaria, sistemas de riego, etc. 
para la obtención de productos agrícolas tales como alimentos 
y fibras. 


111. Capital para obtención de recursos: fabricación de taladros, equipos 
de minería, poliductos, refinerías, etc. para la obtención de materia 
prima y energía que requieren las otras formas de capital. 


Iv. Bienes de consumo: fabricación de vestidos, carros, electrodomés- 
ticos cuyo valor per cápita incide directamente en la medición del 
bienestar. 


v. Capital industrial: como inversión del mismo capital industrial 
en forma de producción de maquinaria, generadores eléctricos, 
molinos, etc. 


La figura 13.4 muestra la dinámica general del capital industrial. Hay dos 
lazos de realimentación, uno positivo y otro negativo, que corresponden 
a las inversiones y a la depreciación, respectivamente. La producción 
industrial depende del capital industrial, que se descompone en los cinco 
ítem arriba señalados. 

Bienes de consumo 

Capital de servicio 


Capital de agricultura 


Capital de obtención de recursos 
A 


Producción Industrial 
A 


Capital 


" Industrial e: 


Inversión (+) (—) Depreciación 


Rata de inversión Vida media del capital 


Figura 13.4 Dinámica general del capital 


El valor monetario anual de los productos físicos de bienes y servicios fina- 
les es el Gross Domestic Product (GDP) o Producto Interno Pruto (PBI). 
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El GDPI (GDP Index o Índice del PBI) es un indicador asociado al GDP. 
El GDPI crece con el GDP per cápita, pero para valores a un cierto umbral 
crece muy lentamente. El umbral utilizado es el GDP per cápita de 1999 
para los países de Europa Occidental. Se calcula como: 


log, GDPpc — log; 24,0 
log¡p 9508 — log; 24,0 


GDPI = 


Submodelos de la contaminación: el modelo incluye una estimación de los 
contaminantes depositados en el ecosistema, así como una medida del im- 
pacto ambiental. La acumulación de contaminantes es proporcional a la 
utilización de recursos y a la tierra cultivable utilizada para agricultura. 
Una fracción de los contaminantes acumulados se asimila de nuevo por el 
ecosistema global. 


El modelo incluye también el efecto que pueden tener las nuevas tecnolo- 
gías que se usen para disminuir la producción de contaminantes. El mo- 
delo se basa en la inversión que se haga en estas tecnologías. No se incluye 
ningún modelo físico sobre el origen de los contaminantes ni su control. 
Tampoco hay un modelo sobre el efecto invernadero ni el calentamiento 
global. 


En cuanto a la medida del impacto ambiental, esta se estima utilizando el 
concepto de huella ecológica propuesto por Mathis Wackernagel en 
[WOB*99]. La huella ecológica se define como el área de tierra necesa- 
ria para proveer la actual forma de vida. Se mide en hectáreas (promedio). 
El concepto incluye áreas de cultivo, pastos, bosques, zonas de pesca y tie- 
rras de construcción necesarias para mantener la población actual de una 
determinada región con un estilo de vida dado. Se le suma el área de bos- 
que requerida para absorber el dióxido de carbono emitido por la energía 
fósil usada. 


En el modelo se define la Human Ecological Footprint (HEF) o Huella Eco- 
lógica Humana como un indicador del impacto ambiental semejante a la 
definición de Wackernagel. La HEF está normalizada al valor de 1970. Para 
su cálculo se suman tres áreas (medidas en 10? hectáreas): 


1. Tierra cultivable para la producción agrícola de alimentos. 


11. Tierra urbana utilizada para la infraestructura urbana, industrial y de 
transporte. 
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111. Tierra requerida para neutralizar la emisión de contaminantes. Se cal- 
cula de forma proporcional a la generación de contaminantes 
persistentes. 


Submodelos de bienestar: el modelo de bienestar humano emplea el Hu- 
man Develpoment Index (HDI) o Índice de Desarrollo Humano, que es 
publicado anualmente por el Programa de la Naciones Unidas para el Desa- 
rrollo (PNUD). 


En el modelo se define el Human Welfare Index (HWD) o Índice de Bienes- 
tar Humano como un indicador semejante al HDI. El HWI es el promedio 
de tres índices: 


1. Life Expectancy Index (LEI) o Índice de Expectativa de Vida, calcula- 
do de forma proporcional a la expectativa de vida. 


11. Education Index (El) o Índice de Educación, proporcional a la alfabe- 
tización y al nivel de escolaridad, que además dependen del nivel de 
industrialización. 


1. Bruto Gross Domestic Product Index (GDPID) o Índice del Producto 
Interno, ya definido antes. 


Submodelos de producción de alimentos: la producción de alimentos se 
modela en función de lo siguientes aspectos: 


1. La tierra cultivable disponible. 
1. El rendimiento de la tierra cultivable. 
111. El desperdicio y las pérdidas del alimento producido. 


Iv. Los requerimientos de alimento por persona. 


El modelo de la producción de alimentos es quizás donde más fácilmente 
se evidencia la naturaleza global del modelo. No se modelan los mecanis- 
mos de distribución de alimentos ni se estiman las diferencias regionales 
de producción y acceso. 


Submodelos de recursos No Renovables: el modelo busca estimar la va- 
riación de las reservas de materiales y fuentes de energía no renovables. 
El modelo utiliza como parámetro la cantidad total de recursos naturales 
en todo el planeta en el año 1900. Este parámetro, no obstante, es imposi- 
ble de conocer con mediana certeza. De hecho, es uno de los aspectos más 
criticados de este modelo y de los anteriores de los mismos autores. 
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13. 
En 


La naturaleza global del modelo hace que no se puedan distinguir las va- 
riaciones entre los diferentes recursos naturales. El petróleo es, sin duda, 
el recurso que mayor preocupación ha causado en los autores del modelo. 


La inversión en tecnología se incorpora al modelo en dos formas: como la 
posibilidad de extraer más eficientemente los recursos, y como la posibili- 
dad de utilizarlos más eficientemente. 


1.2.3 Escenarios de análisis 


[MRMO5] se formulan diferentes posibles escenarios “futuros” (visto desde 


el 2002). Estos escenarios son los siguientes: 
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= Escenario 1: es el escenario de referencia. Corresponde a la simulación 
bajo las condiciones “actuales” de consumo, uso de recursos, natalidad, 
etc. De acuerdo con los resultados de la simulación, “la población y la 
producción crecen hasta que el crecimiento se detiene por la inaccesi- 
bilidad creciente de los recursos no renovables... (al caer la producción) 
los alimentos, y servicios de salud se reducen disminuyendo la expecta- 
tiva de vida e incrementando las tasas promedio de muerte” ([MRMO5], 
pág. 168). 


= Escenario 2: es un escenario con recursos no renovables más abundan- 
tes. En este escenario se duplica la estimación de recursos no renovables 
iniciales (en 1900) y se suponen adelantos tecnológicos que posponen 
el incremento en los costos de extracción. Como resultado la produc- 
ción industrial y la población continúan creciendo veinte años más que 
en el escenario 1, “pero los niveles de contaminación se disparan, dete- 
riorando el rendimiento de la tierra y exigiendo enormes inversiones en 
recuperación de la agricultura. La población finalmente desciende a cau- 
sa de la escasez de alimentos y los efectos negativos en la salud derivados 
de la contaminación” ([MRMO5], pág. 172). 


= Escenarios 3, 4, 5 y 6: suponen adelantos tecnológicos que cambian 
el panorama. Se construyen a partir del escenario 2. Los adelantos se 
producen debido a la decisión de invertir más recursos en tecnología. 
Se estima un tiempo de implementación de veinte años para las nuevas 
tecnologías. En concreto, los adelantos tecnológicos permiten: mejorar 
el control de la contaminación (escenarios 3 y siguientes), incremen- 
tar el rendimiento agrícola (escenarios 4 y siguientes); incrementar la 
protección contra la erosión (escenarios 5 y siguientes), utilizar más efi- 
cientemente los recursos (escenario 6). Como resultado, los adelantos 
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“permiten un mundo simulado bastante amplio y prospero, hasta que 
la felicidad empieza a declinar en respuesta al costo acumulado de las 
tecnologías” ([MRMO5], pág. 218). 


= Escenario 7: supone un esfuerzo por realizar un control demográfico. Se 
construye a partir del escenario 2. Se supone que todas las parejas de- 
ciden limitar el tamaño de sus familias a dos hijos, y logran hacerlo de 
forma completamente efectiva. El crecimiento de la población tarda una 
generación en verse disminuido, y facilita el crecimiento industrial. No 
obstante, el crecimiento “se detiene por el costo derivado de la contami- 
nación, tal como en el Escenario 2” ([MRMO5], pág. 240). 


= Escenario 8: supone además del control demográfico una cambio en la 
dinámica del consumo. La decisión es la de mantener un consumo in- 
dustrial per cápita estable, cercano a un 110 % del promedio mundial en 
el año 2000. El modelo supone una repartición homogénea del producto 
industrial*, lo que implicaría una mejora notabilísima entre los pobres 
del mundo, y un cambio en los patrones de consumo de los ricos. Como 
resultado se logra prolongar el estado favorable del Escenario 8, “pero la 
contaminación afecta crecientemente los recursos agrícolas. La produc- 
ción per cápita de alimentos decae, disminuyendo la expectativa de vida 
y la población” ([MRMO5], pág. 242). 


= Escenario 9: es una combinación de los escenarios 3 al 8. En él se supone 
la utilización de los adelantos tecnológicos, así como la incorporación 
de control demográfico y consumo responsable. El resultado es una so- 
ciedad “sostenible: cerca de 8 mil millones de personas viven con un alto 
bienestar humano y generando una huella ecológica que disminuye con- 
tinuamente” ([MRMO5], pág. 244). 


= Escenarios 10 y 11: se simula la incorporación de las acciones correc- 
tivas del escenario 9 en otros momentos. El escenario 10 explora la in- 
corporación veinte años antes (en 1982), y el escenario 11 lo hace diez 
años después (en 2012). En el primer caso el resultado es una sociedad 
sostenible con “menor población, menos contaminación, más recursos 
No Renovables y un bienestar humano ligeramente superior para to- 
dos”*([MRMO5], pág. 248). 


3En la documentación no hay claridad sobre la manera de incorporar esta suposición de repartición 
homogénea en el modelo, dada la naturaleza global de este. 
4El escenario 11 no es explorado por Meadows, pero sí es implementado por Cellier en [Cel08]. 
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13.2 PLANTAS DE EXPERIMENTACIÓN Y EXPERIMENTOS SUGERIDOS 


Planta de experimentación 13: World3. 


Presentación: el modelo corresponde a la implementación de Cellier del 
modelo de la dinámica del mundo propuesto por Meadows, sobre un tra- 
bajo previo de Forrester. 


Instrumentación: el modelo cuenta con 19 parámetros ajustables organiza- 
dos en 6 grupos de controles (véase tabla 13.1). Como resultado del experi- 
mento, el programa despliega: 


= 8 curvas organizadas en 6 gráficos (véase tabla 13.2). 


= Una tabla de datos del comportamiento de 9 variables (véase tabla 
13.3). 


Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 13.1: Recursos disponibles. 


¿Qué efectos tiene subestimar o sobreestimar la cantidad total de recurso 
naturales disponibles? El parámetro Recursos Iniciales, del grupo Recur- 
sos No Renovables, corresponde a la estimación (en TeraToneladas) de la 
cantidad de recursos naturales disponibles en 1900. Explore el efecto de 
este parámetro. 


Experimento 13.2: Eficiencia en la obtención de recursos no renovables. 


¿Qué impacto tiene la inversión en tecnología para obtener más eficiente- 
mente los recursos no renovables? Explore el impacto de incorporar una 
política de inversión de recursos para aumentar la eficiencia del proceso 
de obtención de recursos no renovables. 
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Experimento 13.3: Control de la contaminación. 


¿Qué efecto tiene limitar la contaminación? Los parámetros 1 y 2 del gru- 
po Control de Contaminación controlan el esfuerzo de una política de 
inversión en nuevas tecnologías para controlar la contaminación. Explore 
el efecto de estos parámetros. 


Experimento 13.4: Obsolescencia tecnológica. 


¿Cómo impacta el hecho de tener productos más o menos duraderos? 
Compare los impactos de variaciones en la vida media de cada tipo de 
producto, cuando se implementa una política de equilibrio del consumo. 


Experimento 13.5: Escenarios de Meadows. 


¿Qué conclusiones pueden extraerse de los diferentes escenarios propues- 
tos por Meadows? Meadows propuso varios escenarios (modelados por 
Cellier). Simule los diferentes escenarios, analice el comportamiento del 
modelo y compare sus conclusiones con las de Meadows. 


Experimento 13.6: Sensibilidad y robustez. 


¿Qué tan sensible y robusto es el modelo? Analice la robustez y sensibilidad 
del modelo con combinaciones de modificaciones de los parámetros. 


4La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 
hay datos tanto en español como en inglés. 
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Tabla 13.1 Parámetros del experimento 13, “World3” 


Título: World3 

Descripción: El modelo corresponde a la implementación de Cellier del modelo de la 
dinámica del mundo propuesto por Meadows, sobre un trabajo previo 
de Forrester. 
Implementación 

Créditos e-mail 

Parámetro; 
Grupo Nombre Modelica Nombre Descripción 


Recursos No Renovables 


Natural Resources 


Recursos iniciales 


Estimación de los recursos 
no renovables disponibles en 
1900, medidos en 10*? Ton. 


Control de Contaminación 


poll1 


Parámetro 1 


Multiplicador para cambio 
de tecnología de control de 
la contaminación cuando los 
Contaminantes son muy altos. 


poll2 


Parámetro 2 


Multiplicador para cambio 
de tecnología de control de 
la contaminación cuando los 
Contaminantes son bajos. 


Producción agrícola eficiente 


yieldl 


Parámetro 1 


Multiplicador para cambio de 
tecnología agrícola cuando 
hay pocos alimentos faltantes. 


yield2 


Parámetro 2 


Multiplicador para cambio 
de tecnología agrícola cuan- 
do hay muchos alimentos 
faltantes. 


Uso eficiente de recursos 


techl 


Parámetro 1 


Multiplicador para cambio de 
tecnología de uso de recur- 
sos no renovables cuando hay 
gran escasez de recursos. 


tech2 


Parámetro 2 


Multiplicador para cambio de 
tecnología de uso de recursos 
no renovables cuando hay po- 
ca escasez de recursos. 


Equilibrio de consumo 


ind_out_pc_des Producción Meta de producción industrial 
deseada en equilibrio. 

p_avg_life_agr_imp_2 | Vida de bienes Vida útil media de los bienes 
agrícolas agrícolas producidos. 

p_avg_life_ind_cap_2 | Vida de bienes Vida útil media de los bienes 
industriales industriales producidos. 


p_avg_life_serv_cap_2 


Vida de servicios 


Vida útil media de los servicios 
producidos. 


Acciones correctivas 


caorFlag Obtención Inversión en aumento de la efi- 
eficiente de ciencia para la obtención de 
recursos NR recursos faltantes. 

pollFlag Control de Inversión en tecnología para 
contaminación control de la contaminación. 

landFlag Control de Inversión en tecnología para 
erosión control de erosión. 

fertFlag Control Control demográfico. 
demográfico 
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Acciones correctivas 


equilFlag Equilibrio de Mantener las proporción de 
consumo consumo en relación a la pro- 
ducción industrial. 
Tyes Año Inicial Año de inicio de las acciones 
correctivas. 
techFlag Uso eficiente Inversión en aumento de la efi- 
de recursos ciencia para la utilización de 
recursos no renovables. 
yieldFlag Producción Inversión en aumento de la efi- 


agrícola eficiente 


ciencia en la producción de ali- 
mentos. 


Tabla 13.2 Figuras del experimento 13, “World3” 


Población 


Población mundial : (10%9 hab) vs (year) 


a ad 
y S 
Recursos naturales 

Recursos naturales : (1012 Ton) vs (year) 
pa Y 
a Sy 


Expectativa de vida 


a 


Expectativa de vida : (year) vs (year) 


Población 
Curva Descripción T Y 
Población Población mundial , 
; anno | population 
mundial de seres humanos 
Recursos naturales 
Curva Descripción z Y 
Recursos Recursos naturales natural 
anno 

naturales no renovables resources 
Expectativa de vida 
Curva Descripción zx Y 
Expectativa | Expectativa de a 

Ñ , anno life expectancy 
de vida vida 
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8 A . | 
Producción per cápita 
Producción per cápita 
Producción anual per cápita 
Curva Descripción z y 
Alimento | Alimento per cápita | anno | food_pc 
Servicios Servicios per cápita | anno | serv_out_pc 
Amar A du y1) se Qear) Bienes Bienes per cápita anno | ind_out_pc 
Servicios : (dollar/yr) vs (year) 
Bienes : (dollar/yr) vs (year) 
IG Y 
a Ln. a] 
Huella ecológica 
Huella ecológica 
Curva Descripción T Y 
e an human 
Huella ecológi- | Huella ecológica ; 
anno | _ecological 
ca humana humana ; 
_footprint 
Huella ecológica humana : (Gha) vs (year) 
A Y 
EF y 
Índice de bienestar 
Índice de bienestar 
Curva Descripción T Y 
dd , es ] human 
Índice de bien- | Índice de bienestar 
anno | _welfare 
estar humano humano : 
_index 
Indice de bienestar humano : () vs (year) 
IG Y 
Tabla 13.3 Variables en la tabla de resultados del experimento 13, “World3” 
Variable Descripción Unidades 
anno Año year 
population Población humana mundial 10? hab 
naturalresources Recursos naturales no renovables 101? Ton 
lifeexpectancy Expectativa de vida year 
food_pc Alimento anual per cápita dollar/yr 
serv_out_pc Services anuales per cápita dollar/yr 
ind_out_pc Bienes de consumo per cápita dollar/yr 
human_ecological_footprint Huella ecológica humana Gha 
human_welfare_index Índice de bienestar humano 
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13.3 LA IMPLEMENTACIÓN 


La librería de SystemDynamics desarrollada por Cellier (véase [Cel08]) 
tiene dentro de sus ejemplos la implementación de once diferentes escena- 
rios del modelo del mundo de Meadows (véase [MIM*74]). A partir de la 
implementación del escenario 1 se ha desarrollado una nueva clase (véase el 
archivo MyWorld3.mo) con las siguientes adiciones elementales: 


= Se han definido once variables de salida con nombres cortos, para facili- 
tar su despliegue en UNVirtualLab. Cada una de estas variables corres- 
ponde a alguna de las variables previamente definidas en el modelo de 
la librería. 


= Se han definido veintisiete parámetros que permiten obtener los once 
escenarios del modelo y combinaciones de ellos. Estos parámetros son 
fácilmente incorparbles en la estructura de UNVirtualLab. 


= Se ha fijado el tiempo de simulación desde el año 1900 al año 2100. 


La implementación de Cellier utiliza 13 bloques fuertemente 
interconectados: 


1. Dinámica poblacional 
Fertilidad humana 

Huella ecológica humana 
Dinámica de la contaminación 
Inversión industrial 

Índice de Bienestar Humano 
Dinámica de la tierra cultivable 


Uso de la fuerza laboral 


SP A A 


Expectativa de vida 


. 
[e] 


. Producción de alimentos 


. 
. 


. Fertilidad de la tierra 


. 
lb 


. Uso de recursos no renovables 


h. 
w 


. Inversión en el sector de servicios 


461 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


La planta experimental que se ha diseñado permite simular los diez es- 
cenarios analizados en [MRMO5], uno más propuesto por Cellier, así como 
variaciones y combinaciones de ellos. La tabla 13.4 muestra cómo obtener ca- 
da uno de los once escenarios en la planta experimental. 

Algunos de los escenarios se obtienen fijando ciertos parámetros inter- 
nos del modelo”. La planta permite ajustar esos parámetros, de tal forma 
que puede estudiarse la gradualidad del efecto de cada uno de ellos. Ade- 
más, se han organizado los controles de la planta para destacar el efecto 
de incorporar políticas globales, en forma de decisiones para incorporar 
acciones correctivas. 


Tabla 13.4 Obtención de los escenarios de Meadows en la planta de experimentación de UNVirtualLab 


de recursos 


Parámetro 2 


Modificaciones 
Nombre — Descripción Base Parámetro Valor 
Abundancia de recursos no Obtención eficiente de recursos | SI 
E2 El 
renovables NR 
Recursos Iniciales 2 
Abundancia de recursos no Control de contaminación sI 
E3 renovables, tecnología para control | E2 Control de contaminación. 0,4 
de la contaminación Parámetro 1 
Control de contaminación. 0,4 
Parámetro 2 
Abundancia de recursos no Producción agrícola eficiente SI 
renovables, tecnología para control 
E4 a sia pa E3 Producción agrícola eficiente. 0,4 
de la contaminación, mejora en el > 
A ; Parámetro 1 
rendimiento agrícola 
Producción agrícola eficiente. 0,4 
Parámetro 2 
E5 Abundancia de recursos no renova- | E4 Control de erosión SI 
bles, tecnología para control de la 
contaminación, mejora en el rendi- 
miento agrícola, control de erosión 
Abundancia de recurso no Uso eficiente de recursos SI 
se renovables, tecnología para control ES E 
de la contaminación, mejora en el Uso eficiente de recursos. 0,4 
rendimiento agrícola, control de Parámetro 1 
erosión, tecnología de uso eficiente Uso eficiente de recursos. 0,4 


5El significado de los parámetros ajustables del modelo que llevan la simulación de un escenario a otro 
no está bien documentado por los autores. En general se trata de valores que residen en tablas de datos 
usadas mediante interpolación para estimar factores multiplicadores o ratas de cambio. 
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Modificaciones 
Nombre — Descripción Base Parámetro Valor 
E7 El mundo busca una población es- | E2 Control demográfico SI 
table 
desde el 2002 
Equilibrio de consumo SI 
El mundo busca una población Producción deseada 350 
E8 estable y una producción industrial | E7 Vida de bienes agrícolas 2,5 
PA ADA Vida de bienes industriales 18 
Vida de bienes servicios 25 
Control de contaminación SI 
Control de contaminación. 0,4 
El mundo busca una población Parámetro 1 
estable y una producción industrial Control de contaminación. 0,4 
per cápita estable y utiliza Parámetro 2 
E9 tecnologías BREA control de E8 Producción agrícola eficiente SI 
contaminación, mejora en el 
rendimiento agrícola, control de Producción agrícola eficiente. 0,4 
erosión, tecnología de uso eficiente Parámetro 1 
de recursos, desde el 2002 Producción agrícola eficiente. 0,4 
Parámetro 2 
Control de erosión SI 
Uso eficiente de recursos SI 
Uso eficiente de recursos. 0,4 
Parámetro 1 
Uso eficiente de recursos. 0,4 
Parámetro 2 
E1l0 Las políticas del escenario 9 fueron | E9 Año inicial 1982 
implementadas veinte años atrás 
Ell Las políticas del escenario 9 seim- | E9 Año inicial 2012 
plementan diez años después 


13.3.1 Listado de archivos 


La tabla 13.5 muestra el listado de los archivos fuente de la implementación 


del modelo. 
Tabla 13.5 Archivos del modelo 
Número Archivo 
13.1 MyWorld3.mo 
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Archivo 13.1 MyWorld3.mo 
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14 


IDENTIFICACIÓN ALGEBRAICA. MASA 
DESLIZANTE CON FRICCIÓN 


El modelo ilustra la utilización de la técnica de identificación de 
parámetros por métodos algebraicos, mediante su aplicación al 
caso elemental de una masa deslizante con fricción. 


El problema de identificación de parámetros 
consiste en la estimación de los valores numéri- 
cos de los parámetros de modelos matemáticos 
de sistemas, basados en la información prove- 
niente del comportamiento histórico de dichos 
sistemas. El problema usualmente se aplica al 
caso de sistemas dinámicos. 


_ E 


Figura 14.1 Masa deslizante 


La identificación algebraica es una técnica recientemente propuesta por 
Sira y otros (véase [SRGRCRLJ14]). Utiliza manipulaciones algebraicas de los 
modelos matemáticos para deducir expresiones que permiten realizar estima- 


ciones en línea de los parámetros del modelo. 


El primer ejemplo que se analiza en [SRGRCRLJ14] es el de una masa 
deslizante sujeta a una fuerza. El problema de identificación consiste en es- 
timar la masa a partir de mediciones de la fuerza y el desplazamiento. En 
esta implementación se simula esa planta y el mecanismo de identificación. 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


Se han adicionado: 1) ruido en las mediciones, y 2) una fricción de Coulomb 
entre la masa y la superficie. 


14.1 EL MODELO 


El desplazamiento x(t) de una masa m deslizante sobre la que se ejerce una 
fuerza u(t) sin rozamiento, está regido por las leyes de Newton: 


má(t) = f(t) (14.1) 


Para estimar el parámetro m usando el enfoque de la identificación alge- 
braica es necesario obtener una estimación m.¿(t) que evolucione en el tiempo, 
en función de las variables medibles e independiente de las condiciones ini- 
ciales. Si se tuviese un registro de la aceleración ¿(t) y de la fuerza f(t), esta 
estimación podría ser: 


fil) = (14.2) 
Sin embargo, si las variables medibles son el desplazamiento x(t) y la fuerza 
F(t), es necesario obtener otra relación matemática. Para ello, se multiplica la 


expresión 14.1 por (t — tp)? a cada lado de la ecuación y se integra dos veces, 
en donde ty es el tiempo inicial: 


m(t — to" ¿(t) = (t— to)" F(t) (14.3) 
14.1.1 Primera integración 


Para realizar una primera integración utilizamos la variable auxiliar o: 
t t 


m | (9 —to?i(0)do = (0 — to)? f(0)do (14.4) 


to to 
La integral de la izquierda puede analizarse utilizando el método de integra- 
ción por partes: 


u= (0—tp? du = i(o)do du = 2(0—to)do v=(0) (14.5) 


d(uv) = udv + vdu Juato = uv — Jr (14.6) 


] (0 — to)%5(0)d0 = (0 —t0)?4(0)|', —2 l (o=idildo (147) 
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Y por tanto, al retomar 14.4: 


t 


m 6 —t0?i5(t) — 2/ 


to 


(0 — tohalo do a ] (o—-t0*floldo (149) 


0 


Para analizar la integral de la izquierda, podemos de nuevo hacer uso del mé- 
todo de integración por partes, definiendo ahora u y dv como 


u= (0 — to) du = i(0)do du = do u=ul0) (14.10) 


d(uv) = udv + udu Juao = uv = for (14.11) 
/ (0 —toJá(oJdo = (9 —toja(o)l!, / (da (14.12) 
'/ (o — to)i[lo)do = (t — to)a(t) — / x(0)do (14.13) 


Y por tanto 14.9 se transforma en 


t 


m ( —t0?5(t) — 2(t — tp)a(t) + 2/ 


to 


t 
elojdo Ss / ida 

t 

j (14.14) 
La expresión 14.14 permitiría desarrollar una estimación de m a partir de las 
mediciones de x(t), 2(t) y F(t): 


J;, (0 —to)?f(0)d0 


(14.15) 
(t — to)?5(t) — At — toju(t) +2 f,, z(0)do 


al= 


14.1.2 Segunda integración 


Para obtener una estimación que no requiera el registro de 2(t) se integra nue- 
vamente la expresión 14.14 


t 


m 0 O O O TEO 1 Í slojdo De 


to 0 


t A 
0 / (9 —to)?flo)dodA (14.16) 
to to 
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t 
hi / Asia —2 | ida aya f e (ojdoda] — 
to to 4to 
/ Fi g— toy? o)dodA (14.17) 
to to 


La primera de las integrales de la izquierda se analiza utilizando de nuevo el 
método de integración por partes: 


u=(A-=tp0?  —dvu=(AdA  du=2A—tpdA  u=x(A) 
(14.18) 


d(uv) = udv + vdu Juato = uv — frá (14.19) 


Fo — to)?a(0)do = (At0 HA), — ¿La to) (AA (14.20) 


0 


t 


l A / (At2)IA (1421) 


10) to 


La ecuación 14.22 se transforma en 


m 6 —t*r(t) — f (A — to) (A)dA + 2 f Pa eel 
to to 
Y Fi g— toy? o)dodA (14.22) 
to to 


lo que permite obtener una estimación del parámetro m en términos del re- 
gistro histórico de x(t) y f(t)!: 


me(t) = == (14.23) 


o= ff (a — to) o)dodA (14.24) 
to “to 


n(t) = (t—to)?x(t) el (A—to)z o Pa o)dodA (14.25) 
to to 


lSeguimos aquí parcialmente la notación usada en [SRGRCRLJ14], que estima 1/me = n(t)/d(t), 
numerador sobre denominador. 
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14.1.3 Realizaciones 


Las realizaciones de 14.24 y 14.25 se obtienen con derivaciones sucesivas: 


dt) = 


+ 
— 
! 


(t-to?x(t) + 21(t) 
—4(t — to)x(t) + za(t) 
20(t) 
(14.26) 


Las realizaciones 14.26 pueden visualizarse como se muestra en la figu- 
ra 14.2. D y N' pueden interpretarse como dos filtros variantes en el tiempo 
especificados por 14.26. Sobre este esquema, en [SRGRCRLJ14] se proponen 
además tres variaciones (véase figura 14.3): 


oa 


Arbitrario 


Figura 14.3 Diagrama de bloques del proceso de estimación con filtrado de señal 


a. Para evitar que la estimación de m¿ en 14.23 sea indeterminada cuando 
n(t) = 0, el proceso de identificación se inicia después de un tiempo t.. 
Para tiempos menores a £, se utiliza como estimación un valor arbitrario. 


b. Debido a que los filtros D y N son inestables, el proceso debe reiniciarse de 
cuando en cuando. 
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c. Para suavizar la estimación, se propone un filtrado de las señales d(t) y n(t) 
consistente en una doble integración. 


14.2 PLANTAS DE EXPERIMENTACIÓN Y EXPERIMENTOS SUGERIDOS 


Planta de experimentación 14: Masa con fricción. 


Presentación: la planta consiste en un modelo de masa deslizante con fric- 
ción de Coulomb al que se le aplica una fuerza que puede ser de dos tipos: 
constante o sinusoidal (de periodo 15). La magnitud de la fuerza se pue- 
de modificar así como la masa nominal. La fricción de Coulomb se modela 
como un valor absoluto constante que se puede modificar; el sentido de la 
fuerza de fricción es opuesto al sentido del desplazamiento. La masa, ade- 
más, se detiene si el desplazamiento excede un valor máximo que puede ser 
ajustado por el usuario. 

Sobre esta planta se toman las señales de desplazamiento y fuerza. La 
planta incorpora ruido aditivo sobre las mediciones, cuya amplitud se puede 
modificar. 

El proceso de identificación puede o no incorporar el filtrado de n(t) y 
de d(t). Para evitar la indeterminación en la expresión 14.23, la división solo 
se realiza si [n(t)| > nin, en donde nin es un valor modificable. 


Instrumentación?: el modelo cuenta con 10 parámetros ajustables organi- 


zados en 3 grupos de controles (véase tabla 14.1). Como resultado del expe- 
rimento, el programa despliega: 


= 6 curvas organizadas en 4 gráficos (véase tabla 14.2). 


= Una tabla de datos del comportamiento de 7 variables (véase tabla 
14.3). 


Experimentos sugeridos: el siguiente es el listado de experimentos 
sugeridos: 


Experimento 14.1: Ruido en las mediciones. 


¿Qué efecto tiene el ruido en las mediciones sobre la estimación de la ma- 
sa? Explore el efecto que tiene la amplitud del ruido en las mediciones del 
desplazamiento y la fuerza en la precisión de la estimación y el tiempo de 
estabilización de la estimación. 
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Experimento 14.2: Estímulo. 


¿Qué efecto tiene el estímulo del sistema sobre el proceso de identifica- 
ción? Explore el impacto de alterar la forma y magnitud de la fuerza que 
estimula la planta en el proceso de identificación. 


Experimento 14.3: Fricción. 


¿Cómo afecta la fricción de Coulomb la calidad de la identificación? Ex- 
plore el efecto de la fricción de Coulomb en la precisión de la identificación 
de la masa, así como en el tiempo de estabilización de la identificación. 


Experimento 14.4: Reinicio de la identificación. 


¿Cada cuanto tiempo debería reiniciarse la identificación? El proceso im- 
¿ p Pp 
plementado utiliza dos variables n(t) y d(t) que tienen un comportamiento 


inestable. Explore qué factores inciden en la evolución de estas variables y 
estime el tiempo en que deberían reiniciarse sus valores. 


Experimento 14.5: Filtrado de señales. 


¿Qué efecto tiene suavizar las mediciones de fuerza y desplazamiento? Ex- 
plore el efecto de filtrar las señales de numerador y denominador. El filtro 
implementado consiste en un doble integrador. 


Experimento 14.6: Filtrado de mediciones. 


¿Qué efecto tiene filtrar las señales medidas? Implemente un filtro pasa- 
bajos para la señal de fuerza y otro para la señal de desplazamiento, y ex- 
plore su impacto sobre el proceso de identificación. 
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Experimento 14.7: Tiempo mínimo de identificación. 


¿A partir de qué instante de tiempo está disponible la identificación? En la 
implementación se utiliza el parámetro N min para controlar el momen- 


to en que la relación d/n es útil para dar una identificación de la masa. 
Explore el efecto de este parámetro sobre el tiempo de identificación. 


Tabla 14.1 Parámetros del experimento 14, “Masa con fricción” 


Título: Masa con fricción 
Descripción: Identificación algebraica del parámetro de masa en un arreglo simple de 
masa deslizante con fricción de Couñlomb 
Implementación 
Créditos e-mail 
Parámetros 
Grupo Nombre Modelica Nombre Descripción 
oia M.flagFuerza Tipo Tipo de fuerza aplicada 
M.Fa Amplitud Magnitud de la fuerza aplicada 
M.mo Masa Masa real del cuerpo 
Planta M.M.F_Coulomb Fricción Fricción de Coulomb 
M.smazx X máxima Máximo desplazamiento de la 
masa 
stopTime Tiempo de simulación Tiempo de simulación 
M.Nzx.stdev Ruido en x Ruido en la medición del des- 
Identificación plazamiento 
M.Nu.stdev Ruido en F Ruido en la medición de la 
fuerza 
I.FlagFiltro Filtrado de señales Filtrado de numerador y deno- 
minador 
I.ne N min Valor mínimo de n(t) 


2La información en las tablas siguientes se muestra tal como aparece en la base de datos. Por esta razón 


hay datos tanto en español como en inglés. 
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Tabla 14.2 Figuras del experimento 14, “Masa con fricción” 


Masa estimada 


Masa estimada 


Masa estimada y Masa real 


Curva Descripción z Y 
Masa estimada time IMe 
Masa real Masa real time M.MR 

Masa estimada : (Kg) vs (s) 

Masa real : (kg) vs (s) 

r > 
Fuerza 

Fuerza 


Fuerza aplicada como estímulo a la planta 


Curva Descripción zx y 
Fuerza Fuerza aplicada time | M. Faplicada 
Fuerza : (N) vs (s) 
8 =] z 
Fracción 
— Fracción 
Términos algebraicos de numerador y denominador 
Curva Descripción z 7) 
n(t) Numerador time In 
d(t) Denominador time Ld 
nt) : -) vs (s) 
dít) : (-) vs (s) 
A 
Desplazamiento 
Desplazamiento de la masa 
Curva Descripción z Y 
, Desplazamiento de á 
Desplazamiento P time M.M.s 
la masa 


Desplazamiento : (m) vs (s) 


Tabla 14.3 Variables en la tabla de resultados del experimento 14, “Masa con fricción” 


Variable Descripción Unidades 
time time s 

I.Me Masa estimada kg 

M.MR kg 
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M-Faplicada Amplitud de la fuerza aplicada N 


Ln 


numerador de 1/Me 


Ld denominador de 1/Me 
Absolute position of center of com- 
M.Mss ponent (s = flange_a.s + L/2 = flan- m 
ge_b.s - L/2) 


14.3 LA IMPLEMENTACIÓN 


La figura 14.4 ilustra la implementación que se explica a continuación: 
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= La clase idmasa (véase archivo idmasa.mo) contiene un objeto de la cla- 


se masa y otro de la clase identificador que se conectan a través de 
las variables f,, (t) y 2 (1), que representan las mediciones de fuerza y 
desplazamiento, respectivamente. 


M es un objeto de la clase MassWithStopAndFriction de la Modelica 
Standard Library. Esta clase implementa una masa deslizante con varios 
tipos de fricción y un deslizamiento acotado entre —Sm y Sm. En es- 
ta implementación solo se utiliza la fricción de Coulomb, cuyo valor se 
ajusta a través de Fc. El valor de la masa se ajusta mediante M.. 


La fuerza aplicada f(t) y el desplazamiento x(t) se miden. En cada una 

de las mediciones se adiciona ruido (ny (t) y n.(t)), cuyas amplitudes se 

ajustan con Ry y R¿. Para generar el ruido aditivo se ha hecho uso de 

la solución propuesta en [For02]; esta solución emplea archivos externos 

en lenguaje C para la inicialización (véase archivo ext_initRandNormal.c) 
y uso (véase archivo ext_RandNormal.c) del generador de números alea- 

torios. 


La fuerza aplicada puede ser sinusoidal o constante. La selección se rea- 
liza mediante 7'F. La amplitud de la fuerza se ajusta con F,.. 


La clase identificador (véase archivo identificador.mo) es del tipo 
partial. La clase identificadorBase (véase archivo identificador- 
Base.mo) completa la implementación mediante la definición de N y 
D (ecuación 14.26). 


En el proceso de identificación se puede utilizar o no el filtro de doble 
integración que opera sobre las salidas de N y D. La selección se controla 
con £;. 
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= Para evitar la indeterminación de la ecuación 14.23, se utiliza el condi- 
cional que evalúa si [n(t)| > N,n. En caso de no cumplir el condicional, 
el valor estimado de M. no se altera (Me=pre (Me)). 
14.3.1 Listado de archivos 
La tabla 14.4 muestra el listado de los archivos fuente de la implementación 
del modelo. 


Tabla 14.4 Archivos del modelo 


Número Archivo 

14.1 identificador.mo 

14.2 identificadorBase.mo 
14,3 identificadorFriccion.mo 
14.4 idmasa.mo 

14.5 masa.mo 

14.6 ext_initRandNormal.c 
14.7 ext_RandNormal.c 


Archivo 14.1 identificador.mo 
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Archivo 14.2 identificadorBase.mo 


Archivo 14.3 identificadorFriccion.mo 


Archivo 14.4 idmasa.mo 
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Archivo 14.5 masa.mo 


Archivo 14.6 ext_initRandNormal.c 
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Archivo 14.7 ext_RandNormal.c 
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LICENCIAMIENTO 


UN VirtualLab y los modelos alojados en UNVirtualLab se distribuye bajo licencia GNU Versión 3.0 (ver [Fou22]). A con- 
tinuación se reproduce la licencia oficial en inglés, y una traducción no oficial al español tomada de [AAM? 22]. 


VERSIÓN OFICIAL EN INGLÉS 


Copyright O 2007 Free Software Foundation, Inc. http: //fsf .org/ 


Everyone is permitted to copy and distribute verbatim copies of this 
license document, but changing it is not allowed. 


Abstract: The GNU General Public License is a free, copyleft license for software and other kinds of works. 

The licenses for most software and other practical works are designed to take away your freedom to share and change 
the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all 
versions of a program-to make sure it remains free software for all its users. We, the Free Software Foundation, use the 
GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You 
can apply it to your programs, too. 

When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed 
to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you 
receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, 
and that you know you can do these things. 

To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. 
Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to 
respect the freedom of others. 

For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients 
the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must 
show them these terms so they know their rights. 

Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) 
offer you this License giving you legal permission to copy, distribute and/or modify it. 

For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. 
For both users' and authors sake, the GPL requires that modified versions be marked as changed, so that their problems 
will not be attributed erroneously to authors of previous versions. 

Some devices are designed to deny users access to install or run modified versions of the software inside them, 
although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users” freedom to 
change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is 
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precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for 
those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those 
domains in future versions of the GPL, as needed to protect the freedom of users. 


Finally, every program is threatened constantly by software patents. States should not allow patents to restrict deve- 


lopment and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that 
patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot 
be used to render the program non-free. 
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The precise terms and conditions for copying, distribution and modification follow. 


TERMS AND CONDITIONS 


0. Definitions 


“This License” refers to version 3 of the GNU General Public License. 
“Copyright” also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. 


“The Program” refers to any copyrightable work licensed under this License. Each licensee is addressed as “you”. 
“Licensees” and “recipients” may be individuals or organizations. 


To “modify” a work means to copy from or adapt all or part ofthe work in a fashion requiring copyright permission, 
other than the making of an exact copy. The resulting work is called a “modified version” of the earlier work or a 
work “based on” the earlier work. 


A “covered work” means either the unmodified Program or a work based on the Program. 


To “propagate” a work means to do anything with it that, without permission, would make you directly or secon- 
darily liable for infringement under applicable copyright law, except executing it on a computer or modifying a 
private copy. Propagation includes copying, distribution (with or without modification), making available to the 
public, and in some countries other activities as well. 


To “convey” a work means any kind of propagation that enables other parties to make or receive copies. Mere 
interaction with a user through a computer network, with no transfer of a copy, is not conveying. 


An interactive user interface displays “Appropriate Legal Notices” to the extent that it includes a convenient and 
prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is 
no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work 
under this License, and how to view a copy of this License. If the interface presents a list of user commands or 
options, such as a menu, a prominent item in the list meets this criterion. 


Source Code 


The “source code” for a work means the preferred form of the work for making modifications to it. “Object code” 
means any non-source form of a work. 


A “Standard Interface” means an interface that either is an official standard defined by a recognized standards 
body, or, in the case of interfaces specified for a particular programming language, one that is widely used among 
developers working in that language. 


The “System Libraries” of an executable work include anything, other than the work as a whole, that (a) is included 
in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) 
serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which 
an implementation is available to the public in source code form. A “Major Component” in this context, means a 
major essential component (kernel, window system, and so on) of the specific operating system (if any) on which 
the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. 


The “Corresponding Source” for a work in object code form means all the source code needed to generate, install, 
and (for an executable work) run the object code and to modify the work, including scripts to control those ac- 
tivities. However, it does not include the works System Libraries, or general-purpose tools or generally available 
free programs which are used unmodified in performing those activities but which are not part of the work. For 
example, Corresponding Source includes interface definition files associated with source files for the work, and 
the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to 
require, such as by intimate data communication or control flow between those subprograms and other parts of 
the work. 


The Corresponding Source need not include anything that users can regenerate automatically from other parts of 
the Corresponding Source. 


The Corresponding Source for a work in source code form is that same work. 
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2. Basic Permissions 


All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable 
provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the un- 
modified Program. The output from running a covered work is covered by this License only if the output, given 
its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as 
provided by copyright law. 


You may make, run and propagate covered works that you do not convey, without conditions so long as your 
license otherwise remains in force. You may convey covered works to others for the sole purpose of having them 
make modifications exclusively for you, or provide you with facilities for running those works, provided that you 
comply with the terms of this License in conveying all material for which you do not control copyright. Those 
thus making or running the covered works for you must do so exclusively on your behalf, under your direction 
and control, on terms that prohibit them from making any copies of your copyrighted material outside their 
relationship with you. 


Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is 
not allowed; section 10 makes it unnecessary. 


3. Protecting Users' Legal Rights From Anti-Circumvention Law 


No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling 
obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibi- 
ting or restricting circumvention of such measures. 


When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to 
the extent such circumvention is effected by exercising rights under this License with respect to the covered work, 
and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the 
works users, your or third parties” legal rights to forbid circumvention of technological measures. 


4. Conveying Verbatim Copies 


You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that 
you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices 
stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact 
all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. 


You may charge any price or no price for each copy that you convey, and you may offer support or warranty 
protection for a fee. 


5. Conveying Modified Source Versions. 


You may convey a work based on the Program, or the modifications to produce it from the Program, in the form 
of source code under the terms of section 4, provided that you also meet all of these conditions: 


a) The work must carry prominent notices stating that you modified it, and giving a relevant date. 


b) The work must carry prominent notices stating that it is released under this License and any conditions 
added under section 7. This requirement modifies the requirement in section 4 to “keep intact all notices”. 


c) You must license the entire work, as a whole, under this License to anyone who comes into possession ofa 
copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of 
the work, and all its parts, regardless of how they are packaged. This License gives no permission to license 
the work in any other way, but it does not invalidate such permission if you have separately received it. 


d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the 
Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not 
make them do so. 


A compilation of a covered work with other separate and independent works, which are not by their nature ex- 
tensions of the covered work, and which are not combined with it such as to form a larger program, in or on a 
volume of a storage or distribution medium, is called an “aggregate” if the compilation and its resulting copyright 
are not used to limit the access or legal rights of the compilatior's users beyond what the individual works permit. 
Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. 


6. Conveying Non-Source Forms 


You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also 
convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: 
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a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), 
accompanied by the Corresponding Source fixed on a durable physical medium customarily used for soft- 
ware interchange. 


b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), 
accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or 
customer support for that product model, to give anyone who possesses the object code either (1) a copy of 
the Corresponding Source for all the software in the product that is covered by this License, on a durable 
physical medium customarily used for software interchange, for a price no more than your reasonable cost 
of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a 
network server at no charge. 


c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding 
Source. This alternative is allowed only occasionally and noncommercially, and only if you received the 
object code with such an offer, in accord with subsection 6b. 


d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equiva- 
lent access to the Corresponding Source in the same way through the same place at no further charge. You 
need not require recipients to copy the Corresponding Source along with the object code. If the place to 
copy the object code is a network server, the Corresponding Source may be on a different server (operated 
by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions 
next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the 
Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy 
these requirements. 


e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object 
code and Corresponding Source of the work are being offered to the general public at no charge under 
subsection 6d. 


A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System 
Library, need not be included in conveying the object code work. 


A “User Product” is either (1) a “consumer product”, which means any tangible personal property which is nor- 
mally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into 
a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of 
coverage. For a particular product received by a particular user, “normally used” refers to a typical or common 
use of that class of product, regardless of the status of the particular user or of the way in which the particular 
user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of 
whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the 
only significant mode of use of the product. 


“Installation Information” for a User Product means any methods, procedures, authorization keys, or other infor- 
mation required to install and execute modified versions of a covered work in that User Product from a modified 
version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the 
modified object code is in no case prevented or interfered with solely because modification has been made. 


If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and 
the conveying occurs as part of a transaction in which the right of possession and use of the User Product is 
transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), 
the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But 
this requirement does not apply if neither you nor any third party retains the ability to install modified object code 
on the User Product (for example, the work has been installed in ROM). 


The requirement to provide Installation Information does not include a requirement to continue to provide sup- 
port service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User 
Product in which it has been modified or installed. Access to a network may be denied when the modification itself 
materially and adversely affects the operation of the network or violates the rules and protocols for communication 
across the network. 


Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a 
format that is publicly documented (and with an implementation available to the public in source code form), and 
must require no special password or key for unpacking, reading or copying. 


. Additional Terms 


“Additional permissions” are terms that supplement the terms of this License by making exceptions from one or 
more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though 
they were included in this License, to the extent that they are valid under applicable law. Ifadditional permissions 
apply only to part ofthe Program, that part may be used separately under those permissions, but the entire Program 
remains governed by this License without regard to the additional permissions. 
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When you convey a copy of a covered work, you may at your option remove any additional permissions from that 
copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases 
when you modify the work.) You may place additional permissions on material, added by you to a covered work, 
for which you have or can give appropriate copyright permission. 


Notwithstanding any other provision of this License, for material you add to a covered work, you may (ifauthorized 
by the copyright holders of that material) supplement the terms of this License with terms: 


a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this 
License; or 


b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in 
the Appropriate Legal Notices displayed by works containing it; or 


c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such 
material be marked in reasonable ways as different from the original version; or 


d) Limiting the use for publicity purposes of names of licensors or authors of the material; or 


e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service 
marks; or 


f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material 
(or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that 
these contractual assumptions directly impose on those licensors and authors. 


All other non-permissive additional terms are considered “further restrictions” within the meaning of section 10. 
If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License 
along with a term that is a further restriction, you may remove that term. Ifa license document contains a further 
restriction but permits relicensing or conveying under this License, you may add to a covered work material 
governed by the terms of that license document, provided that the further restriction does not survive such 
relicensing or conveying. 


If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a 
statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. 


Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated 
as exceptions; the above requirements apply either way. 


Termination 


You may not propagate or modify a covered work except as expressly provided under this License. Any attempt 
otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (in- 
cluding any patent licenses granted under the third paragraph of section 11). 


However, if you cease all violation of this License, then your license from a particular copyright holder is reinsta- 
ted (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) 
permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days 
after the cessation. 


Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies 
you of the violation by some reasonable means, this is the first time you have received notice of violation of this 
License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of 
the notice. 


Termination of your rights under this section does not terminate the licenses of parties who have received copies 
or rights from you under this License. If your rights have been terminated and not permanently reinstated, you 
do not qualify to receive new licenses for the same material under section 10. 


Acceptance Not Required for Having Copies 


You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation 
of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise 
does not require acceptance. However, nothing other than this License grants you permission to propagate or mo- 
dify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying 
or propagating a covered work, you indicate your acceptance of this License to do so. 


Automatic Licensing of Downstream Recipients 


Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to 
run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by 
third parties with this License. 
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An “entity transaction” is a transaction transferring control of an organization, or substantially all assets of one, 
or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity 
transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the 
work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession 
of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it 
with reasonable efforts. 


You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. 
For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under 
this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging 
that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any 
portion ofit. 


Patents 


A “contributor” is a copyright holder who authorizes use under this License of the Program or a work on which 
the Program is based. The work thus licensed is called the contributor's “contributor version”. 


A contributor's “essential patent claims” are all patent claims owned or controlled by the contributor, whether 
already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of 
making, using, or selling its contributor version, but do not include claims that would be infringed only as a con- 
sequence of further modification of the contributor version. For purposes of this definition, “control” includes the 
right to grant patent sublicenses in a manner consistent with the requirements of this License. 


Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essen- 
tial patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents 
of its contributor version. 


In the following three paragraphs, a “patent license” is any express agreement or commitment, however denomi- 
nated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent 
infringement). To “grant” such a patent license to a party means to make such an agreement or commitment not 
to enforce a patent against the party. 


If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work 
is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available 
network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be 
so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) 
arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream 
recipients. “Knowingly relying” means you have actual knowledge that, but for the patent license, your conveying 
the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more 
identifiable patents in that country that you have reason to believe are valid. 


If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring 
conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work autho- 
rizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you 
grant is automatically extended to all recipients of the covered work and works based on it. 


A patent license is “discriminatory” ifit does not include within the scope of its coverage, prohibits the exercise of, 
or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. 
You may not convey a covered work if you are a party to an arrangement with a third party that is in the business 
of distributing software, under which you make payment to the third party based on the extent of your activity of 
conveying the work, and under which the third party grants, to any of the parties who would receive the covered 
work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you 
(or copies made from those copies), or (b) primarily for and in connection with specific products or compilations 
that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior 
to 28 March 2007. 


Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infrin- 
gement that may otherwise be available to you under applicable patent law. 


No Surrender of Others” Freedom 


If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions 
of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work 
so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a 
consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty 
for further conveying from those to whom you convey the Program, the only way you could satisfy both those 
terms and this License would be to refrain entirely from conveying the Program. 
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Use with the GNU Affero General Public License 


Notwithstanding any other provision of this License, you have permission to link or combine any covered work 
with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, 
and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered 
work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction 
through a network will apply to the combination as such. 


Revised Versions of this License 


The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from 
time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address 
new problems or concerns. 


Each version is given a distinguishing version number. Ifthe Program specifies that a certain numbered version of 
the GNU General Public License “or any later version” applies to it, you have the option of following the terms and 
conditions either of that numbered version or of any later version published by the Free Software Foundation. If 
the Program does not specify a version number of the GNU General Public License, you may choose any version 
ever published by the Free Software Foundation. 


If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be 
used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version 
for the Program. 


Later license versions may give you additional or different permissions. However, no additional obligations are 
imposed on any author or copyright holder as a result of your choosing to follow a later version. 


Disclaimer of Warranty 


There is no warranty for the program, to the extent permitted by applicable law. except when otherwise stated 
in writing the copyright holders and/or other parties provide the program “as is” without warranty of any kind, 
either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness 
for a particular purpose. the entire risk as to the quality and performance of the program is with you. should the 
program prove defective, you assume the cost of all necessary servicing, repair or correction. 


Limitation of Liability 


In no event unless required by applicable law or agreed to in writing will any copyright holder, or any other party 
who modifies and/or conveys the program as permitted above, be liable to you for damages, including any general, 
special, incidental or consequential damages arising out of the use or inability to use the program (including but 
not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure 
of the program to operate with any other programs), even if such holder or other party has been advised of the 
possibility of such damages. 


Interpretation of Sections 15 and 16 


If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according 
to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil 
liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the 
Program in return for a fee. 


END OF TERMS AND CONDITIONS 


How to Apply These Terms to Your New Programs 


If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to 
achieve this is to make it free software which everyone can redistribute and change under these terms. 


To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to 
most effectively state the exclusion of warranty; and each file should have at least the “copyright” line and a pointer 
to where the full notice is found. 


<one line to give the program's name and a brief idea of what it does.> 


Copyright (C) <textyear> <name of author> 
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This program is free software: you can redistribute it and/or modify 
it under the terms of the GNU General Public License as published by 
the Free Software Foundation, either version 3 of the License, or 
(at your option) any later version. 


This program is distributed in the hope that it will be useful, 
but WITHOUT ANY WARRANTY; without even the implied warranty of 
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 
GNU General Public License for more details. 


You should have received a copy of the GNU General Public License 
along with this program. If not, see <http://www.gnu.org/licenses/>. 


Also add information on how to contact you by electronic and paper mail. 


If the program does terminal interaction, make it output a short notice like this when it starts in an interactive 
mode: 


<program> Copyright (C) <year> <name of author> 


This program comes with ABSOLUTELY NO WARRANTY; for details type "show w'. 
This is free software, and you are welcome to redistribute it 
under certain conditions; type "show c' for details. 


The hypothetical commands show wand show c should show the appropriate parts of the General Public License. 
Of course, your progran's commands might be different; for a GUI interface, you would use an “about box”. 


You should also get your employer (if you work as a programmer) or school, ifany, to sign a “copyright disclaimer” 
for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see 
http://www.gnu.org/licenses/. 


The GNU General Public License does not permit incorporating your program into proprietary programs. Ifyour 
program is a subroutine library, you may consider it more useful to permit linking proprietary applications with 
the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But 
first, please read http: //www.gnu.org/philosophy/why-not-1gp1.html. 


A.1 TRADUCCIÓN NO OFICIAL 


Esta es una traducción no oficial al español de la GNU General Public License. No ha sido publicada por la Free Software 
Foundation, y no establece legalmente las condiciones de distribución para el software que usa la GNU GPL -estas condiciones 
se establecen solamente por el texto original, en inglés, de la GNU GPL. Sin embargo, esperamos que esta traducción ayude a 
los hispanohablantes a entender mejor la GNU GPL. 


This is an unofficial translation of the GNU General Public License into Spanish. It was not published by the Free 
Software Foundation, and does not legally state the distribution terms for software that uses the GNU GPL -only the original 
English text of the GNU GPL does that. However, we hope that this translation will help Spanish speakers understand the GNU 
GPL better. 


Copyright O 2007 Free Software Foundation, Inc. http: //fsf .org/ 


Se permite la copia y distribución de copias literales de este documento, pero no se permite su modificación. 


Abstract: La Licencia Pública General de GNU es una licencia libre, bajo “copyleft”, para software y otro tipo de obras. 

Las licencias para la mayoría del software y otras obras de carácter práctico están diseñadas para privarle de la 
libertad de compartir y modificar las obras. Por el contrario, la Licencia Pública General de GNU pretende garantizar su 
libertad de compartir y modificar todas las versiones de un programa —para cerciorar que permanece como software libre 
para todos sus usuarios. Nosotros, la Free Software Foundation, usamos la Licencia Pública General de GNU para la mayoría 
de nuestro software; la cual se aplica también a cualquier otra obra publicada de esta forma por parte de sus autores. Usted 
también puede aplicarla a sus programas. 

Cuando hablamos de software libre (free software), nos referimos a libertad, no a precio. Nuestras Licencias Públicas 
Generales están diseñadas para garantizar su libertad de distribuir copias de software libre (y cobrar por ellas si lo desea), 
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recibir el código fuente o poder obtenerlo si quiere, modificar el software o usar fragmentos de él en sus nuevos programas, 
y que sepa que puede hacer esas cosas. 

Para proteger sus derechos, necesitamos impedir que otros le denieguen esos derechos o que le pidan que renuncie 
a ellos. Por ello, tiene ciertas responsabilidades si distribuye copias del software, o si lo modifica: la responsabilidad de 
respetar la libertad de otros. 

Por ejemplo, si distribuye copias de un programa, bien sea gratis o por una tasa, debe transferirles a los que lo reciban 
las mismas libertades que usted recibió. Debe asegurarse que ellos, también, reciben o pueden obtener el código fuente. Y 
debe mostrarles estos términos para que ellos puedan conocer sus derechos. 

Los desarrolladores que usan la GNU GPL protegen tus derechos con dos pasos: (1) haciendo valer el derecho de 
propiedad intelectual en el software, y (2) ofreciéndole esta Licencia que le da el permiso legal para copiarlo, distribuirlo 
y/o modificarlo. 

Para la protección de autores y desarrolladores, la GPL explica claramente que no hay garantía para este software 
libre. Por el bien tanto de usuarios como de autores, la GPL requiere que las versiones modificadas sean marcadas como 
con cambios, de forma que sus problemas no puedan ser atribuidos de forma errónea a autores de versiones previas. 

Algunos dispositivos están diseñados para denegar a los usuarios el acceso para instalar o ejecutar versiones mo- 
dificadas del software en su interior, a pesar de que el fabricante puede hacerlo. Esto es fundamentalmente incompatible 
con el objetivo de proteger la libertad de los usuarios de modificar el software. El modelo sistemático de este abuso ocurre 
en el ámbito de los productos de uso personal, lo cual es precisamente donde es más inaceptable. Por consiguiente, hemos 
diseñado esta versión de la GPL para prohibir la práctica de estos productos. Si estos problemas surgen de forma substancial 
en otro dominios, estamos preparados para extender esta disposición a esos dominios en futuras versiones de la GPL, así 
como sea necesario para proteger la libertad de los usuarios. 

Por último, todo programa es amenazado constantemente por las patentes de software. Los Estados no deberían 
permitir patentes que restringen el desarrollo y el uso de software en ordenadores de propósito general, pero en aquellos 
que lo hacen, deseamos evitar el peligro particular de que las patentes aplicadas a un programa libre podrían convertirlo 
de forma efectiva en propietario. Para prevenir esto, la GPL garantiza que las patentes no pueden ser utilizadas para hacer 
que el programa no sea libre. 

Los términos exactos y las condiciones para la copia, distribución y modificación se exponen a continuación. 


TÉRMINOS Y CONDICIONES 


0. Definiciones 
“Esta Licencia” se refiere a la versión 3 de la Licencia Pública General de GNU. 


“Derechos de Autor (“Copyright”)” también incluye a las leyes similares a la de derechos de autor (“copyright”) 
que se apliquen a otro tipo de obras, tales como las máscaras usadas en la fabricación de semiconductores. 


“El Programa” se refiere a cualquier obra con derechos de autor (“copyright”) bajo esta Licencia. Cada licenciatario 
es tratado como “usted”. Los “Licenciatarios” y los “destinatarios” pueden ser individuos u organizaciones. 


“Modificar” una obra quiere decir copiar de ella o adaptar parte o la totalidad de la obra de una forma que se re- 
quieran permisos de derechos de autor (“copyright”), distintos de los de hacer una copia exacta. La obra resultante 
es llamada “versión modificada” de la obra previa o una obra “basada en” la obra previa. 


Una “obra amparada” significa o el Programa sin modificar o una obra basada en el Programa. 


“Difundir” una obra significa hacer cualquier cosa con ella que, sin permiso, le haría responsable de forma directa 
o indirecta de infringir la ley correspondiente de derechos de autor (“copyright”), excepto ejecutarla en un orde- 
nador o modificar una copia privada. La difusión incluye copiar, la distribución (con o sin modificación), hacerla 
disponible para el público, y en algunos países también otras actividades. 


“Transmitir” una obra quiere decir cualquier tipo de difusión que permita a otras partes hacer o recibir copias. La 
mera interacción con un usuario a través de una red informática, sin la transferencia de una copia, no es transmitir. 


Una interfaz interactiva de usuario muestra “Avisos Legales Apropiados” en la medida que incluye una caracte- 
rística visible práctica y destacable que (1) muestra un aviso apropiado de derechos de autor (“copyright”), e (2) 
informa al usuario de que no hay garantía para la obra (excepto las garantías proporcionadas), que los licenciata- 
rios pueden transmitir la obra bajo esta Licencia, y cómo ver una copia de esta Licencia. Si la interfaz presenta una 
lista de comandos de usuario u opciones, como un menú, un elemento destacado en la lista satisface este criterio. 


1. Código fuente 


El “código fuente” de una obra significa la forma preferida de trabajo para hacerle modificaciones. “Código objeto” 
es cualquier forma no-fuente de una obra. 


Una “Interfaz Estándar” significa una interfaz que es un estándar oficial definido por un cuerpo de estándares 
reconocido o, en el caso de interfaces especificadas para un lenguaje de programación en particular, una que es 
extensamente utilizada entre los desarrolladores que trabajan en ese lenguaje. 
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Las “Bibliotecas del Sistema” de una obra ejecutable incluyen cualquier cosa, diferente de la obra como un todo, 
que (a) están incluidas en la forma normal de paquetizado de un Componente Importante, y (b) sirve solo para 
habilitar el uso de la obra con ese Componente Importante, o para implementar una Interfaz Estándar para la 
cual la implementación está disponible para el público en forma de código fuente. Un “Componente Importante”, 
en este contexto, significa un componente esencial importante (kernel, sistema de ventanas, etcétera) del sistema 
operativo en concreto (si hubiese) en el cual el ejecutable funciona, o un compilador utilizado para producir la 
obra, o un intérprete de código objeto utilizado para hacerlo funcionar. 


La “Fuente Correspondiente” de una obra en forma de código objeto significa todo el código fuente necesario 
para generar, instalar, y (para una obra ejecutable) hacer funcionar el código objeto y modificar la obra, incluyen- 
do scripts para controlar dichas actividades. Sin embargo, ello no incluye la obra de las Bibliotecas del Sistema, o 
herramientas de propósito general o programas de libre disponibilidad general los cuales son usados sin modifi- 
caciones para la realización de dichas actividades, pero que no son parte de la obra. Por ejemplo, la Fuente Co- 
rrespondiente incluye ficheros de definición de interfaces asociados a los ficheros fuente para la obra, y el código 
fuente para bibliotecas compartidas y subprogramas enlazados dinámicamente para los que la obra está especí- 
ficamente diseñado para requerir, tales como comunicación de datos intrínseca o flujo de control entre aquellos 
subprogramas y otras partes de la obra. 


La Fuente Correspondiente es necesario que no incluya nada que los usuarios puedan regenerar automáticamente 
desde otras partes de la Fuente Correspondiente. 


La Fuente Correspondiente de una obra en forma de código fuente es la obra en sí. 


Permisos básicos 


Todos los derechos concedidos bajo esta Licencia se conceden durante la duración de los derechos de autor (“copy- 
right”) del Programa, y son irrevocables siempre que se cumplan las condiciones establecidas. Esta Licencia afirma 
explícitamente su ilimitado permiso para ejecutar el Programa sin modificar. La salida de la ejecución de una obra 
amparada está amparada por esta Licencia solo si la salida, dado su contenido, constituye una obra amparada. Esta 
Licencia reconoce sus derechos de uso razonable u otro equivalente, según lo establecido por la ley de derechos 
de autor (“copyright”). 


Usted podrá realizar, ejecutar y difundir obras amparadas que usted no transmita, sin condición alguna, siempre 
y cuando no tenga otra licencia vigente. Podrá distribuir obras amparadas a terceros con el único propósito de que 
ellos hagan modificaciones exclusivamente para usted, o proporcionarle ayuda para ejecutar estas obras, siempre 
y cuando cumpla con los términos de esta Licencia en la transmisión de todo el material del cual usted no controle 
los derechos de autor (“copyright”). Aquellos que realicen o ejecuten las obras amparadas por usted, deben hacerlo 
exclusivamente en su nombre, bajo su dirección y control, en los términos que le prohiban realizar ninguna copia 
de su trabajo con derechos de autor (“copyright”) fuera de su relación con usted. 


La transmisión bajo otras circunstancias se permite únicamente bajo las condiciones expuestas a continuación. 
No está permitido sublicenciar, la sección 10 hace que sea innecesario. 


Protección de los Derechos Legales de los Usuarios frente a la Ley Antievasión 


Ninguna obra amparada debe considerarse parte de una medida tecnológica efectiva, a tenor de lo establecido 
en cualquier ley aplicable que cumpla las obligaciones expresas en el artículo 11 del tratado de derechos de autor 
(“copyright”) de WIPO adoptado el 20 de diciembre de 1996, o leyes similares que prohiban o restrinjan la evasión 
de tales medidas. 


Cuando transmita una obra amparada, renuncia a cualquier poder legal para prohibir la evasión de medidas tec- 
nológicas mientras tales evasiones se realicen en ejercicio de derechos amparados por esta Licencia respecto a la 
obra amparada; además, usted renunciará a cualquier intención de limitar el uso o modificación del trabajo con 
el objetivo de imponer, contra el trabajo de los usuarios, sus derechos legales o los de terceros para prohibir la 
evasión de medidas tecnológicas. 


Transmisión de copias literales 


Usted podrá distribuir copias literales del código fuente del Programa tal cual lo ha recibido, por cualquier medio, 
siempre que publique visible y apropiadamente en cada copia el correspondiente aviso de derechos de autor (“copy- 
right”); mantenga intactos todos los avisos que establezcan que esta Licencia y cualquier cláusula no-permisiva 
añadida acorde con la cláusula 7 son aplicables al código; mantenga intactos todos los avisos de ausencia de ga- 
rantía; y proporcione a todos los destinatarios una copia de esta Licencia junto con el Programa. 


Usted podrá cobrar cualquier importe o no cobrar nada por cada copia que distribuya, y podrá ofrecer soporte o 
protección de garantía mediante un pago. 
Transmisión de versiones modificadas de la fuente 


Usted puede transmitir una obra basada en el Programa, o las modificaciones para generarla a partir del Programa, 
en la forma de código fuente bajo los términos de la sección 4, suponiendo que además cumpla las siguientes 
condiciones: 


LICENCIAMIENTO 


a) La obra debe incluir avisos destacados indicando que usted la ha modificado y dando una fecha pertinente. 


b) La obra debe incluir avisos destacados indicando que está liberada bajo esta Licencia y cualquier otra 
condición añadida bajo la sección 7. Este requerimiento modifica los requerimientos de la sección 4 de 
“mantener intactos todos los avisos”. 


c) Usted debe licenciar la obra entera, como una unidad, bajo esta Licencia para cualquier persona que esté 
en posesión de una copia. Esta Licencia se aplicará por consiguiente, junto con cualquier término aplicable 
adicional de la sección 7, a la totalidad de la obra, y a todos sus componentes, independientemente de como 
estén empaquetados. Esta Licencia no da permiso para licenciar la obra de otra forma, pero no invalida 
esos permisos si usted los ha recibido de forma separada. 


d) Si la obra tiene interfaces de usuario interactivas, cada una debe mostrar los Avisos Legales Apro- 
piados; sin embargo, si el Programa tiene interfaces interactivas que no muestren los Avisos Legales 
Apropiados, tampoco es necesario que su obra lo haga. 


Una recopilación de una obra amparada con otras obras separadas e independientes, que no son por su naturaleza 
extensiones de la obra amparada, y que no se combinan con ella con el fin de formar un programa más grande, en 
o sobre un volumen de un medio de almacenamiento o distribución, es llamado un “agregado” si la recopilación 
y su resultante derechos de autor (“copyright”) no son usados para limitar el acceso o los derechos legales de los 
usuarios de la recopilación más allá de lo que las obras individuales permitan. La inclusión de una obra amparada 
en un agregado no provoca que esta Licencia se aplique a los otros componentes del agregado. 


Transmisión en forma de no-fuente 


Usted puede transmitir una obra amparada en forma de código objeto bajo los términos de las secciones 4 y 5, 
siempre que también transmita la Fuente Correspondiente legible por una máquina bajo los términos de esta 
Licencia, de una de las siguientes formas: 


a) Transmitir el código objeto en, o embebido en, un producto físico (incluyendo medios de distribución físi- 
cos), acompañado de la Fuente Correspondiente en un medio físico duradero habitual para el intercambio 
de software. 


b) Transmitir el código objeto en, o embebido en, un producto físico (incluyendo medios de distribución 
físicos), acompañado de un ofrecimiento escrito, válido durante al menos tres años y válido mientras usted 
ofrezca recambios o soporte para ese modelo de producto, de dar a cualquiera que posea el código objeto o 
(1) una copia de la Fuente Correspondiente de todo el software en el producto amparado por esta Licencia, 
en un medio físico duradero habitual para el intercambio de software, por un precio no más elevado que 
el coste razonable de la realización física de la transmisión de la fuente, o (2) acceso para copiar la Fuente 
Correspondiente de un servidor de red sin costo alguno. 


c) Transmitir copias individuales del código objeto con una copia del ofrecimiento escrito de proveer la Fuen- 
te Correspondiente. Esta alternativa está permitida solo ocasionalmente sin fines comerciales, y solo si 
usted ha recibido el código objeto con ese ofrecimiento, de acuerdo con la subsección 6b. 


d) Transmitir el código objeto ofreciendo acceso desde un lugar determinado (gratuitamente o mediante pa- 
go), y ofrecer acceso equivalente a la Fuente Correspondiente de la misma manera en el mismo lugar sin 
cargo adicional. No es necesario exigir a los destinatarios que copien la Fuente Correspondiente junto con 
el código objeto. Si el lugar para copiar el código objeto es un servidor de red, la Fuente Correspondiente 
puede estar en un servidor diferente (gestionado por usted o un tercero) que soporte facilidades de co- 
pia equivalentes, siempre que mantenga instrucciones claras junto al código objeto especificando dónde 
encontrar la Fuente Correspondiente. Independientemente de qué servidor albergue la Fuente Correspon- 
diente, usted seguirá estando obligado a asegurar que está disponible durante el tiempo que sea necesario 
para satisfacer estos requisitos. 


e) Transmitir el código objeto usando una transmisión peer-to-peer, siempre que informe a los otros usuarios 
donde se ofrece el código objeto y la Fuente Correspondiente de la obra al público general de forma gratuita 
bajo la subsección 6d. 


Una porción separable del código objeto, cuyo código fuente está excluido de la Fuente Correspondiente, como 
una Biblioteca del Sistema, no necesita ser incluida en la distribución del código objeto de la obra. 


Un “Producto de Usuario” es o (1) un “producto de consumo”, lo que significa cualquier propiedad tangible 
personal que es usada habitualmente con fines personales, familiares o domésticos, o (2) cualquier cosa diseñada 
o vendida para ser incorporada en una vivienda. A la hora de determinar cuando un producto es un producto 
de consumo, los casos dudosos serán resueltos en favor de la cobertura. Para un producto concreto recibido por 
un usuario concreto, “uso habitual” se refiere a un uso típico y común de esa clase de producto, sin tener en 
cuenta el estado del usuario concreto o la forma en la que el usuario concreto realmente use, o espera o se espera 
que use, el producto. Un producto es un producto de consumo independientemente de si el producto tiene usos 
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esencialmente comerciales, industriales o no comerciales, a menos que dicho uso constituya el único modo de 
uso significativo del producto. 


La “Información de Instalación” de un Producto de Usuario quiere decir cualquier método, procedimiento, clave 
de autorización, u otra información requerida para instalar y ejecutar versiones modificadas de la obra amparada 
en ese Producto de Usuario a partir de una versión modificada de su Fuente Correspondiente. La información debe 
ser suficiente para garantizar que el funcionamiento continuado del código fuente modificado no es prevenido o 
interferido por el simple hecho de que ha sido modificado. 


Si usted transmite una obra en código objeto bajo esta sección en, o con, o específicamete para usar en, un Pro- 
ducto de Usuario, y la transmisión tiene lugar como parte de una transacción en la cual el derecho de posesión y 
uso de un Producto de Usuario es transferido a un destinatario en perpetuidad o por un periodo establecido (in- 
dependientemente de cómo se caracterice la operación), la Fuente Correspondiente transmitida bajo esta sección 
debe estar acompañada de la Información de Instalación. Pero este requisito no se aplica si ni usted ni ningún 
tercero tiene la capacidad de instalar código objeto modificado en el Producto de Usuario (por ejemplo, la obra 
ha sido instalada en la ROM). 


El requisito de proveer de la Información de Instalación no incluye el requisito de continuar proporcionando 
asistencia, garantía, o actualizaciones para una obra que ha sido modificada o instalada por el destinatario, o para 
un Producto de Usuario en el cual ha sido modificada o instalada. El acceso a una red puede ser denegado cuando la 
modificación en sí afecta materialmente y adversamente el funcionamiento de la red o viola las reglas y protocolos 
de comunicación de la red. 


La Fuente Correspondiente transmitida, y la Información de Instalación proporcionada, de acuerdo con esta sec- 
ción debe estar en un formato que sea documentado públicamente (y con una implementación disponible para el 
público en formato de código fuente), y no deben necesitar contraseñas o claves particulares para la extracción, 
lectura o copia. 


Términos adicionales 


Los “Permisos adicionales” son términos que se añaden a los términos de esta Licencia haciendo excepciones de 
una o más de una de sus condiciones. Los permisos adicionales que son aplicables al Programa entero deberán ser 
tratados como si estuvieran incluidos en esta Licencia, en la medida bajo la ley aplicable. Silos permisos adicionales 
solo son aplicables a parte del Programa, esa parte debe ser usada separadamente bajo esos permisos, pero el 
Programa completo queda bajo la autoridad de esta Licencia sin considerar los permisos adicionales. 


Cuando se transmite una copia de una obra derivada, se puede opcionalmente quitar cualesquiera permisos adi- 
cionales de esa copia, o de cualquier parte de ella. Los permisos adicionales pueden ser escritos para requerir su 
propia eliminación bajo ciertos casos cuando se modifica la obra. Se pueden colocar permisos adicionales en ma- 
terial, añadidos a una obra derivada, para los cuales se establecen o se pueden establecer los permisos de derechos 
de autor (“copyright”) apropiados. 


No obstante cualquier otra disposición de esta Licencia, para el material que se añada a una obra derivada, se 
puede (si está autorizado por los titulares de los derechos de autor (“copyright”) del material) añadir los términos 
de esta Licencia con los siguientes términos: 


a) Ausencia de garantía o limitación de responsabilidad diferente de los términos de las secciones 15 y 16 de 
esta Licencia; o 


b) Exigirla preservación de determinados avisos legales razonables o atribuciones de autor en ese material o 
en los Avisos Legales Apropiados mostrados por los obras que lo contengan; o 


c) Prohibir la tergiversación del origen de ese material, o requerir que las versiones modificadas del material 
se marquen de maneras razonables como diferentes de la versión original; o 


d) Limitar el uso con fines publicitarios de los nombres de los licenciantes o autores del material; o 


e) Negarse a ofrecer derechos concedidos por leyes de registro para el uso de alguno nombres comerciales, 
marcas registradas o marcas de servicio; o 


f) Exigir la compensación de los licenciantes y autores de ese material por cualquiera que distribuya el ma- 
terial (o versiones modificadas del mismo) estableciendo obligaciones contractuales de responsabilidad 
sobre el destinatario, por cualquier responsabilidad que estas obligaciones contractuales impongan direc- 
tamente sobre los licenciantes y autores. 


Todos los demás términos adicionales no permisivos son consideradas “restricciones extra” en el sentido de la 
sección 10. Si el Programa, tal cual se recibió, o cualquier parte del mismo, contiene un aviso indicando que se 
encuentra cubierto por esta Licencia junto con un término que es otra restricción, se puede quitar ese término. 
Si un documento de licencia contiene una restricción adicional, pero permite relicenciar o redistribuir bajo esta 
Licencia, se puede añadir a un material de la obra derivada bajo los términos de ese documento de licencia, a 
condición de que dicha restricción no sobreviva el relicenciamiento o redistribución. 


10. 


11. 


LICENCIAMIENTO 


Si se añaden términos a una obra derivada de acuerdo con esta sección, se debe colocar, en los archivos fuente 
involucrados, una declaración de los términos adicionales aplicables a esos archivos, o un aviso indicando donde 
encontrar los términos aplicables. 


Las términos adicionales, permisivos o no permisivos, pueden aparecer en forma de una licencia escrita por sepa- 
rado, o figurar como excepciones; los requisitos anteriores son aplicables en cualquier forma. 


Conclusiones 


Usted no podrá propagar o modificar una obra amparada salvo lo expresamente permitido por esta Licencia. 
Cualquier intento diferente de propagación o modificación será considerado nulo y automáticamente se anula- 
rán sus derechos bajo esta Licencia (incluyendo las licencias de patentes concedidas bajo el tercer párrafo de la 
sección 11). 


Sin embargo, si usted deja de violar esta Licencia, entonces su licencia de un titular de los derechos de autor (“copy- 
right”) correspondiente será restituida (a) provisionalmente, a menos que y hasta que el titular de los derechos de 
autor (“copyright”) explícita y finalmente termine su licencia, y (b) permanentemente, si el titular del copyright 
no le ha notificado su violación por algún medio razonable antes de los 60 días siguientes a la cesación. 


Además, su licencia de un titular de los derechos de autor (“copyright”) correspondiente será restituida perma- 
nentemente si el titular de los derechos de autor (“copyright”) le notifica la violación por algún medio razonable, 
siendo ésta la primera vez que recibe la notificación de violación de esta Licencia (para cualquier obra) de ese 
titular de los derechos de autor (“copyright”), y usted subsana la violación antes de 30 días después de la recepción 
de la notificación. 


La cancelación de sus derechos bajo esta sección no da por canceladas las licencias de terceros que hayan recibi- 
do copias o derechos de usted bajo esta Licencia. Si sus derechos han sido cancelados y no fueran renovados de 
manera permanente, usted no cumple los requisitos para recibir nuevas licencias para el mismo material bajo la 
sección 10. 


Aceptación no obligatoria por tenencia de copias 


Usted no está obligado a aceptar esta Licencia por recibir o ejecutar una copia del Programa. La propagación adi- 
cional de una obra amparada surgida únicamente como consecuencia de usar una transmisión peer-to-peer para 
recibir una copia tampoco requiere aceptación. Sin embargo, esta Licencia solo le otorga permiso para propagar o 
modificar cualquier obra amparada. Estas acciones infringen los derechos de autor (“copyright”) si usted no acep- 
ta esta Licencia. Por lo tanto, al modificar o distribuir una obra amparada, usted indica que acepta esta Licencia 
para poder hacerlo. 


Herencia automática de licencia para destinatarios 


Cada vez que transmita una obra amparada, el destinatario recibirá automáticamente una licencia de los licencia- 
dores originales, para ejecutar, modificar y distribuir esa obra, sujeto a esa Licencia. Usted no será responsable de 
asegurar el cumplimiento de esta Licencia por terceros. 


Una “transacción de entidad” es una transacción que transfiere el control de una organización, o sustancialmente 
todos los bienes de una, o subdivide una organización, o fusiona organizaciones. Si la propagación de una obra 
amparada surge de una transacción de entidad, cada parte en esa transacción que reciba una copia de la obra 
también recibe todas las licencias de la obra que la parte interesada tuviese o pudiese ofrecer según el párrafo 
anterior, además del derecho a tomar posesión de las Fuentes Correspondientes de la obra a través del predecesor 
interesado, si el predecesor tiene o puede conseguirla con un esfuerzo razonable. 


Usted no podrá imponer ninguna restricción posterior en el ejercicio de los derechos otorgados o concedidos bajo 
esta Licencia. Por ejemplo, usted no puede imponer un pago por licencia, derechos u otros cargos por el ejercicio 
de los derechos otorgados bajo esta Licencia, y no puede iniciar litigios (incluyendo demandas o contrademandas 
en pleitos) alegando cualquier reclamación de violación de patentes por cambiar, usar, vender, ofrecer en venta o 
importar el Programa o alguna parte del mismo. 


Patentes 


Un “colaborador” es un titular de los derechos de autor (“copyright”) que autoriza, bajo los términos de la presente 
Licencia, el uso del Programa o una obra en la que se base el Programa. La obra así licenciada se denomina “versión 
en colaboración” del colaborador. 


Las “demandas de patente esenciales” del colaborador son todas las reivindicaciones de patentes poseídas o con- 
troladas por el colaborador, ya se encuentren adquiridas o hayan sido adquiridas con posterioridad, que sean 
infringidas de alguna manera, permitidas por esta Licencia, al hacer, usar o vender la versión en colaboración, pe- 
ro sin incluir demandas que solo sean infringidas como consecuencia de modificaciones posteriores de la versión 
en colaboración. Para los propósitos de esta definición, “control” incluye el derecho de conceder sublicencias de 
patente de forma consistente con los requisitos establecidos en la presente Licencia. 
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Cada colaborador le concede una licencia de la patente no-exclusiva, global y libre de regalías bajo las demandas de 
patente esenciales del colaborador, para hacer, usar, modificar, vender, ofrecer para venta, importar y otras formas 
de ejecución, modificación y difusión del contenido de la versión en colaboración. 


En los siguientes tres párrafos, una “licencia de patente” se define como cualquier acuerdo o compromiso expreso, 
cualquiera que sea su denominación, que no imponga una patente (como el permiso expreso para ejecutar una 
patente o acuerdos para no imponer demandas por infracción de patente). “Conceder” una licencias de patente de 
este tipo a un tercero significa hacer tal tipo de acuerdo o compromiso que no imponga una patente al tercero. 


Si usted transmite una obra amparada, conociendo que está amparada por una licencia de patente, y las 
Fuentes Correspondientes no se encuentran disponibles de forma pública para su copia, sin cargo alguno y 
bajo los términos de esta Licencia, ya sea a través de un servidor público o mediante cualquier otro medio, 
entonces usted deberá (1) hacer que las Fuentes Correspondientes sean públicas, o (2) tratar de eliminar los 
beneficios de la licencia de patente para esta obra en particular, o (3) tratar de extender, de manera compatible 
con los requisitos de esta Licencia, la licencia de patente a terceros. “Conocer que está afectado” significa que 
usted tiene conocimiento real de que, para la licencia de patente, la distribución de la obra amparada en un 
país, o el uso de la obra amparada por sus destinatarios en un país, infringiría una o más patentes existentes 
en ese país que usted considera válidas por algún motivo. 


Si en virtud de o en conexión con alguna transacción o acuerdo, usted transmite, o difunde con fines de distri- 
bución, una obra amparada, y concede una licencia de patente para algún tercero que reciba la obra amparada, y 
les autorice a usar, transmitir, modificar o difundir una copia específica de la obra amparada, entonces la licencia 
de patente que usted otorgue se extiende automáticamente a todos los receptores de la obra amparada y cualquier 
obra basada en ella. 


Una licencia de patente es “discriminatoria” si no incluye dentro de su ámbito de cobertura, prohibe el ejercicio de, 
o está condicionada a no ejercitar uno o más de los derechos que están específicamente otorgados por esta Licencia. 
Usted no debe transmitir una obra amparada si está implicado en un acuerdo con terceros que esté relacionado 
con el negocio de la distribución de software, en el que usted haga pagos a terceros relacionados con su actividad 
de distribución de la obra, bajo el que terceros conceden, a cualquier receptor de la obra amparada, una licencia de 
patente discriminatoria (a) en relación con las copias de la obra amparada transmitidas por usted (o copias hechas 
a partir de estas), o (b) principalmente para y en relación con productos específicos o compilaciones que contengan 
la obra amparada, a menos que usted forme parte del acuerdo, o que esa licencia de patente fuese concedida antes 
del 28 de marzo de 2007. 


Ninguna cláusula de esta Licencia debe ser considerada como excluyente o limitante de cualquier otra licencia 
implicada u otras defensas legales a que pudiera tener derecho bajo la ley de propiedad intelectual vigente. 


No abandonar la libertad de otros 


Si se le imponen condiciones (bien sea por orden judicial, acuerdo o de otra manera) que contradicen las condi- 
ciones de esta Licencia, estas no le eximen de las condiciones de esta Licencia. Si usted no puede transmitir una 
obra amparada de forma que pueda satisfacer simultáneamente sus obligaciones bajo esta Licencia y cualesquiera 
otras obligaciones pertinentes, entonces, como consecuencia, usted no puede transmitirla. Por ejemplo, si usted 
está de acuerdo con los términos que le obligan a cobrar una regalía por la transmisión a aquellos a los que trans- 
mite el Programa, la única forma en la que usted podría satisfacer tanto esos términos como esta Licencia sería 
abstenerse completamente de transmitir el Programa. 


Utilización con la Licencia Pública General Affero de GNU 


A pesar de cualquier otra disposición de esta Licencia, usted tiene permiso para enlazar o combinar cualquier obra 
amparada con una obra licenciada bajo la Licencia Pública General Affero de GNU en una única obra combinada, 
y para transmitir la obra resultante. Los términos de esta Licencia continuarán aplicándose a la parte que es la obra 
amparada, pero los requisitos particulares de la Licencia Pública General Affero de GNU, sección 13, concernientes 
ala interacción a través de una red se aplicarán a la combinación como tal. 


Versiones revisadas de esta licencia 


La Free Software Foundation puede publicar versiones revisadas y/o nuevas de la Licencia General Pública de GNU 
de vez en cuando. Cada nueva versión será similar en espíritu a la versión actual, pero puede diferir en detalles 
para abordar nuevos problemas o preocupaciones. 


Cada versión recibe un número de versión distintivo. Si el Programa especifica que cierta versión numerada de la 
Licencia General Pública de GNU “o cualquier versión posterior” se aplica a él, usted tiene la opción de seguir los 
términos y condiciones de esa versión numerada o de cualquier versión posterior publicada por la Free Software 
Foundation. Si el Programa no especifica un número de versión de la Licencia General Pública de GNU, usted 
puede escoger cualquier versión publicada por la Free Software Foundation. 


Si el Programa escifica que un representante puede decidir que versiones futuras de la Licencia General Pública 
de GNU pueden ser utilizadas, la declaración pública del representante de aceptar una versión permanentemente 
le autoriza a usted a elegir esa versión para el Programa. 


15. 


16. 


17. 


LICENCIAMIENTO 


Las versiones posteriores de la licencia pueden darle permisos adicionales o diferentes. No obstante, no se impone 
a ningún autor o titular de los derechos de autor obligaciones adicionales como resultado de su elección de seguir 
una versión posterior. 


Descargo de responsabilidad de garantía 


No hay garantía para el programa, para la extensión permitida por la ley aplicable. excepto cuando se indique lo 
contrario por escrito, los titulares de los derechos de autor (“copyright”) y/o terceros proporcionan el programa 
“tal cual” sin garantías de ningún tipo, bien sean explícitas o implícitas, incluyendo, pero no limitado a, las ga- 
rantías implícitas de comercialización y aptitud para un propósito particular. el riesgo total en cuanto a calidad y 
rendimiento del programa es con usted. si el programa presenta algún defecto, usted asume el costo de todas las 
revisiones necesarias, reparaciones o correcciones. 


Limitación de la responsabilidad 


En ningún caso a menos que sea requerido por una ley aplicable o acuerdo escrito ningún titular de los derechos 
de autor (“copyright”), o ningún tercero que modifique y/o transmita el programa como se permite anteriormen- 
te, será responsable ante usted por daños, incluyendo cualesquiera daños generales, particulares, imprevistos o 
derivados del uso o imposibilidad de uso del programa (incluyendo, pero no limitado a, la pérdida de datos, datos 
generados incorrectos, pérdidas sufridas por usted o por terceras personas, o los fallos del programa para operar 
con otros programas), incluso si dicho titular o un tercero ha sido advertido de la posibilidad de tales daños. 


Interpretación de las secciones 15 y 16 


Si el descargo de responsabilidad de garantía y el límite de responsabilidad proporcionado anteriormente no tie- 
ne efectos legales de acuerdo a sus términos, los juzgados deberán aplicar la ley local que más se asemeje a una 
renuncia absoluta de la responsabilidad civil concerniente al Programa, a menos que una garantía o una asunción 
de responsabilidad acompañe a la copia del Programa como resultado del pago de una tasa. 


FIN DE LOS TÉRMINOS Y CONDICIONES 


Cómo aplicar estos términos a sus nuevos programas 


Si desarrolla un nuevo programa, y quiere que sea lo más usado posible por el público, la mejor manera de conse- 
guirlo es hacerlo software libre para que cualquiera pueda redistribuirlo y modificarlo bajo estos términos. 


Para ello, añada la siguiente nota al programa. Lo más seguro es añadirla al principio de cada fichero fuente para 
declarar más efectivamente la exclusión de garantía; y cada fichero debe tener al menos la línea de “derechos de 
autor (“copyright”)” y un puntero a donde se pueda encontrar la anotación completa. 


<una linea para dar el nombre del programa y una breve idea de lo que hace> 
Copyright (C) <año> <nombre del autor> 


Este programa es software libre: puede redistribuirlo y/o modificarlo bajo 
los términos de la Licencia General Pública de GNU publicada por la Free 
Software Foundation, ya sea la versión 3 de la Licencia, o (a su elección) 
cualquier versión posterior. 


Este programa se distribuye con la esperanza de que sea útil pero SIN 
NINGUNA GARANTÍA; incluso sin la garantía implícita de MERCANTIBILIDAD o 
CALIFICADA PARA UN PROPÓSITO EN PARTICULAR. Vea la Licencia General Pública 
de GNU para más detalles. 


Usted ha debido de recibir una copia de la Licencia General Pública 
de GNU junto con este programa. Si no, vea <http://www.gnu.org/licenses/>. 


También añada información sobre cómo contactarle por correo electrónico u ordinario. 


Si el programa es interactivo, haga que muestre un breve aviso como el siguiente cuando se inicie en modo inter- 
activo: 
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<programa> Copyright (C) <año> <nombre del autor> 

Este programa se ofrece SIN GARANTÍA ALGUNA; escriba “show w' para 
consultar los detalles. Este programa es software libre, y usted puede 
redistribuirlo bajo ciertas condiciones; escriba "show c' para más 
información. 


Los hipotéticos comandos show w y show w deberán mostrar las partes correspondientes de la Licencia General 
Pública. Por supuesto, los comandos en su programa pueden ser diferentes; para una interfaz gráfica de usuario, 
puede usar un mensaje del tipo “Acerca de”. 


También debería conseguir que su empresa (si trabaja como programador) o escuela, en su caso, firme una “re- 
nuncia de derechos de autor (“copyright”)” sobre el programa, si fuese necesario. Para más información a este 
respecto, y saber cómo aplicar y cumplir la licencia GNU GPL, consulte http: //www.gnu.org/licenses/. 


La Licencia General Pública de GNU no permite incorporar sus programas como parte de programas propieta- 
rios. Si su programa es una subrutina en una biblioteca, podría considerar mucho más útil permitir el enlace de 
aplicaciones propietarias con la biblioteca. Si esto es lo que quiere hacer, utilice la GNU Lesser General Public 
License en vez de esta Licencia. Pero primero, por favor consulte 


http: //www.gnu.org/philosophy/why-not-1gp1.html. 


ESTRUCTURA DE TABLAS EN LA BASE 
DE DATOS 


Tabla B.1 Tablas y campos en la base de datos 


Sections 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX XxX XxX x 
section_id int A a - - 
name varchar(255) - - Xx - 
description text - - E m 
enabled tinyint - - E > 
Models 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX XxX XxX x 
section_id int - G Xx 5 
name varchar(255) - 5 y E 
title varchar(255) - - E - 
description text - - Bl E 
bibliography text - - E S 
exename varchar(255) - - - Ñ 
enabled tinyint - - 5 a 
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Variables 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX XxX XxX x 
model_id int - - Xx a 
modelicaname varchar(255) - - XxX - 
alias varchar(255) - - 5 pS 
description text - a le y 
units varchar(255) - y - - 
type varchar(255) - - y E 
value varchar(255) - - E = 
Parameters 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX XxX XxX Xx 
model_id int 5 la Xx E 
modelicaname varchar(255) - - Xx - 
alias varchar(255) - y - s 
description text - y E = 
units varchar(255) - - E - 
type varchar(255) - a e a 
value varchar(255) - y - = 
Modellers 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX XxX XxX Xx 
firstname varchar(255) - - Xx - 
lastname varchar(255) - - Xx - 
email varchar(255) - - a = 
Modellers models 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
modeller_id int - £ Xx 5 
model_id int y la Xx Ñ 
Controls 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX XxX XxX x 
control_group_id| int - - Xx - 
name varchar(255) - y - . 
parameter_id int - y Xx - 
description text - - E S 
allowedvalues text - - lá E 
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value varchar(255) - ñ Ñ y 
min float - E 5 > 
max float - E s 5 
step float - - 2 E 
enabled tinyint - - - E 
Control_groups 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX XxX XxX xXx 
model_id int - É Xx 5 
name varchar(255) - - Xx " 
description text - E - 5 
enabled tinyint - - E > 
Plots 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX XxX XxX x 
model_id int a a Xx a 
name varchar(255) - - Xx - 
description text - a E E 
variable_id int - £ - > 
minX float - Ñ - E 
maxX float - á a a 
gridX tinyint - - - a 
autoscaleX char(1) - E = y 
minY float - - E > 
maxY float - A a " 
gridY tinyint - - e a 
autoscaleY char(1) - - - - 
firstdata int - - y s 
enabled tinyint - - E E 
Curves 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX XxX XxX x 
plot_id int - a X = 
name varchar(255) - E XxX S 
legend varchar(255) - - Xx - 
description text - E E S 
variable_id int - a Xx - 
colorRGB varchar(255) - - Ñ S 
enabled tinyint - - E E 
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2danimations 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX XxX XxX x 
name varchar(255) - E XxX > 
description text - - - E 
model_id int - - Xx a 
svg_file varchar(255) - y e - 
duration float - - - s 
sample_time float - - - - 
enabled tinyint - - a E 
2deffects 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX XxX XxX Xx 
name varchar(255) - E - a 
description text - - - a 
2danimation_id int y y - > 


svganimation_id | varchar(255) - a me E 


variable_id int - E E S 


variable_aux_id | int a a e E 


sequence int - y y s 
type varchar(255) - a y E 
offset decimal - á a a 
scale decimal - - 5 Ñ 
colorRGBmin varchar(255) - E = y 
colorRGBmax varchar(255) - E E > 
colorMin decimal - A a a 
colorMax decimal - - A Z 
enabled tinyint - - a - 
Practices 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX Xx Xx XxX 
model_id int 5 5 a a 
name text - - a E 
header text - E - = 
description text - a a = 
enabled tinyint - - - = 
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Users 
Campo Tipo Llave primaria | Único No NULL Autoincremento 
id int XxX XxX x 
user_name varchar(255) - Xx - 
password varchar(255) - Xx - 
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VALORES DE LAS PROPIEDADES DE LAS 
CLASES DE ADMINISTRACIÓN 


En la sección 6.5.2 se explica el propósito de los principales miembros de la 
clase adminblock. El valor que toman esos miembros en cada una de las clases 
hijas es diferente. En este apéndice se muestran esos valores de la siguiente 
forma: 


= La tabla C.1 muestra el contenido de la variable table. 

= La tabla C.2 muestra el contenido del arreglo fields. 

= La tabla C.3 muestra el contenido del arreglo RelationsiN. 

= La tabla C.4 muestra el contenido del arreglo Relations1N1N. 


= La tabla C.5 muestra el contenido del arreglo Relations1NM1. 
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Tabla C.1 Contenido de la propiedad table para las clases de administración 


Clase Table 
adminmodel models 
adminplot plots 
admin2danim 2danimations 
admin2deffect 2deffects 
admincontrol control_groups 
adminpractice practices 
adminsection sections 


Tabla C.2 Contenido del arreglo Fields para las clases de administración 


Arreglo Fields de la clase adminmodel 


* Clave Valor 
dbname id 
0 showname Identificador 
type fixed 
dbname exename 
1 showname Nombre del archivo ejecutable 
type fixed 
dbname name 
2 showname Nombre del modelo 
type text 
dbname title 
3 showname Título del modelo 
type text 
dbname description 
4 showname Descripción 
type longtext 
dbname enabled 
5 showname Habilitado 
type bool 
dbname section_id 
6 showname Sección padre 
type select section 
Arreglo Fields de la clase adminplot 
* Clave Valor 
dbname id 
0 showname Identificador 
type fixed 
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dbname model_id 
1 showname Identificador del modelo 
type model link 
dbname name 
2 showname Nombre de la figura 
type text 
dbname description 
3 showname Descripción 
type longtext 
dbname enabled 
4 showname Habilitado 
type bool 
dbname variable_id 
E showname Variable horizontal 
model_id 0 
type select variable 
dbname minX 
6 showname Valor mínimo de la variable horizontal 
type float 
dbname maxX 
7 showname Valor máximo de la variable horizontal 
type float 
dbname gridX 
8 showname Divisiones horizontales 
type int 
dbname autoscaleX 
A showname Auto-escala horizontal 
value 0 
type bool 
dbname minY 
10 showname Valor mínimo de la variable vertical 
type float 
dbname maxY 
11 showname Valor máximo de la variable vertical 
type float 
dbname gridY 
12 showname Divisiones verticales 
type int 
dbname autoscaleY 
13 showname Auto-escala vertical 


VALORES DE LAS PROPIEDADES DE LAS CLASES DE ADMINISTRACIÓN 


507 


UNVIRTUALLAB. UN LABORATORIO VIRTUAL BASADO EN OPENMODELICA 


value 0 
type bool 
dbname firstdata 
14 showname Primer dato 
type int 
Arreglo Fields de la clase admin2danim 
* Clave Valor 
dbname id 
0 showname Identificador 
type fixed 
dbname model_id 
1 showname Identificador del modelo 
type model link 
dbname name 
2 showname Nombre de la animación 
type text 
dbname description 
3 showname Descripción 
type longtext 
dbname enabled 
4 showname Habilitado 
type bool 
dbname duration 
5 showname Duración 
type float 
dbname sample_time 
6 showname Tiempo de muestreo 
type float 
Arreglo Fields de la clase admin2deffect 
* Clave Valor 
dbname id 
0 showname Identificador 
type fixed 
dbname 2danimation_id 
1 showname Identificador de animación 
type fixed 
dbname name 
2 showname Nombre 
type text 
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dbname description 
showname Descripción 

3 type longtext 
dbname enabled 
showname Habilitado 
type bool 
dbname type 
showname Tipo 

4 options Array 
table 2deffects 
type select options 
dbname svganimation_id 

5 showname Identificador de animación SVG 
type text 
dbname variable_id 

A showname Variable de Control 
model_id 0 
type select variable 
dbname variable_aux_id 

7 showname Variable Auxiliar 
model_id 0 
type select variable 
dbname offset 

8 showname Offset 
type float 
dbname scale 

9 showname Escala 
type float 
dbname colorRGBmin 

10 showname Color RGB mínimo 
type color 
dbname colorRGBmax 

11 showname Color RGB máximo 
type color 
dbname colorMin 

12 showname Valor mínimo de Color 
type float 
dbname colorMax 

13 showname Valor máximo de Color 
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type float 
Arreglo Fields de la clase admincontrol 
4 Clave Valor 
dbname id 
0 showname Identificador 
type fixed 
dbname model_id 
1 showname Valor 
type model link 
dbname name 
2 showname Nombre 
type text 
dbname description 
3 showname Descripción 
type longtext 
dbname enabled 
4 showname Habilitado 
type bool 
Arreglo Fields de la clase adminpractice 
4 Clave Valor 
dbname id 
0 showname Identificador 
type fixed 
dbname name 
1 showname Nombre de la práctica 
type text 
dbname header 
2 showname Encabezado 
type longtext 
dbname description 
3 showname Descripción 
type longtext 
dbname enabled 
4 showname Habilitado 
type bool 
Arreglo Fields de la clase adminsection 
4 Clave Valor 
dbname id 
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showname Identificador 
type fixed 

dbname name 
showname Nombre de la Sección 
type text 

dbname description 
showname Descripción 
type longtext 
dbname enabled 
showname Habilitado 
type bool 

dbname section_id 
showname Sección padre 
type select section 


Tabla C.3 Contenido del arreglo Relations1N para las clases de administración 


Arreglo Relations1N de la clase adminmodel 
Clave Valor 
title Animaciones en 2D 
table 2danimations 
linkname 2danimationid 
idl id 
id2 model_id 
idvalue 0 
showdbname name 
show Nombre de la animación 
title Grupos de controles 
table control_groups 
linkname controlgroupid 
idl id 
id2 model_id 
idvalue 0 
showdbname name 
show Nombre del grupo de controles 
title Prácticas 
table practices 
linkname practiceid 
idl id 
id2 model_id 
idvalue 0 
showdbname name 
show Nombre de las prácticas 
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Arreglo Relations1N de la clase adminplot 


* Clave Valor 


El arreglo está vacío 


Arreglo Relations1N de la clase admin2danim 


E Clave Valor 
title Animación 
table 2deffects 
linkname 2deffectid 

0 idl id 
id2 2danimation_id 
idvalue 0 
showdbname name 
show Nombre 


Arreglo Relations1N de la clase admin2deffect 


* Clave Valor 


El arreglo está vacío 


Arreglo RelationsiN de la clase admincontrol 


E Clave Valor 


El arreglo está vacío 


Arreglo Relations1N de la clase adminpractice 


+ Clave Valor 


El arreglo está vacío 


Arreglo Relations1N de la clase adminsection 


E Clave Valor 
title Secciones hijas 
table sections 
linkname sectionid 
0 idl id 
id2 section_id 
idvalue 0 
showdbname name 
show Nombre de la Sección 
title Modelos 
table models 
linkname modelid 
1 idl id 
id2 section_id 
idvalue 0 
showdbname name 
show Nombre del Modelo 


512 


VALORES DE LAS PROPIEDADES DE LAS CLASES DE ADMINISTRACIÓN 


Tabla C.4 Contenido del arreglo Relations1N1N para las clases de administración 


Arreglo Relations1N1N de la clase adminmodel 
Clave Valor Clave Valor 
El arreglo está vacío 
Arreglo Relations1N1N de la clase adminplot 
Clave Valor Clave Valor 
title Curvas 
table curves 
linkname curveid 
idl id 
id2 plot_id 
idvalue 0 
showdbname | name 
show Nombre de la curva 
dbname id 
0 showname Identificador 
type fixed 
dbname name 
1 showname Nombre de la curva 
type text 
dbname legend 
2 showname Leyenda 
type text 
dbname enabled 
eubricids 3 showname Habilitado 
type bool 
dbname description 
4 showname Descripción 
type longtext 
dbname variable_id 
table showname Variable vertical 
model_id 0 
type select variable 
dbname colorRGB 
5 showname Color 
type color 
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Arreglo Relations1N1N de la clase admin2danim 


E Clave Valor Clave Valor 


El arreglo está vacío 


Arreglo Relations1N1N de la clase admin2deffect 


+ Clave Valor Clave Valor 


El arreglo está vacío 


Arreglo Relations1N1N de la clase admincontrol 


H Clave Valor Clave Valor 
title Controles 
table controls 
linkname controlid 
idl id 
id2 control_group_id 
idvalue 0 


showdbname | name 


show Nombre 

dbname id 

0 showname Identificador 
type fixed 
dbname name 

1 showname Nombre 
type text 
dbname value 

2 showname Valor 
type text 
dbname enabled 

3 showname Habilitado 

0 type bool 

dbname min 

4 showname Mínimo 
type text 

subfields dbname max 

5 showname Máximo 
type text 
dbname step 

6 showname Incremento 
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type text 
dbname allowedvalues 
7 showname Valores permitidos 
type longtext 
0 subfields dbname description 
8 showname Descripción 
type longtext 
dbname parameter_id 
tama showname Parámetro 
model_id 0 
type select parameter 
Arreglo Relations1N1N de la clase adminpractice 
A Clave Valor Clave Valor 
El arreglo está vacío 
Arreglo Relations1N1N de la clase adminsection 
A Clave Valor Clave Valor 
El arreglo está vacío 


Tabla C.5 Contenido del arreglo Relations1NN1 para las clases de administración 


Arreglo Relations1N1N de la clase adminmodel 

H Clave Valor Clave Valor 

title Modeladores 

tableLink modellers_models 

table2 modellers 

linkname modellerid 

idl id 

id2 id 

idLinkl1 model_id 

idLink2 modeller_id 

idvalue 0 

showdbname| concat(lastname,, firstname) 

show Selección 
6 ás 0 lastname 

1 firstname 
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dbname id 
0 showname Identificador 
type fixed 
dbname lastname 
1 showname Apellidos 
subfields type EE 
dbname firstname 
2 showname Nombres 
type text 
dbname email 
3 showname Correo 
type text 
Arreglo Relations1N1N de la clase adminplot 
E Clave Valor Clave Valor 
El arreglo está vacío 
Arreglo Relations1N1N de la clase admin2danim 
H Clave Valor Clave Valor 
El arreglo está vacío 
Arreglo Relations1N1N de la clase admin2deffect 
H Clave Valor Clave Valor 
El arreglo está vacío 
Arreglo Relations1N1N de la clase admincontrol 
Ed Clave Valor Clave Valor 
El arreglo está vacío 
Arreglo Relations1N1N de la clase adminpractice 
Ed Clave Valor Clave Valor 
El arreglo está vacío 
Arreglo Relations1N1N de la clase adminsection 
hd Clave Valor Clave Valor 


El arreglo está vacío 
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PARÁMETROS DEL TEMA UNVLBASIC 


El tema unvlbasic se define en los archivos style.css y styleSVG.css. 
El primero de esos archivos contiene las definiciones generales de toda la apa- 
riencia de la interfaz, mientras que el segundo se ha dedicado a las definiciones 
asociadas con las figuras que muestran los resultados de las simulaciones. 

En este apéndice se documentan las especificaciones CSS de la siguiente 
forma: 


= La tabla D.2 muestra qué parámetros se han definido en cada uno de las 
clases CSS en el archivo style.css. 


= La tabla D.1 muestra el valor asignado a cada uno de los parámetros al 
interior de cada clase CSS, en el archivo style.css. 


= La tabla D.4 muestra qué parámetros se han definido en cada uno de las 
clases CSS en el archivo styleSVG.css. 


= La tabla D.3 muestra el valor asignado a cada uno de los parámetros al 
interior de cada clase CSS, en el archivo styleSVG.css. 
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PARÁMETROS DEL TEMA unvlbasic 
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PARÁMETROS DEL TEMA unvlbasic 
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d.controls 
d.login_button 
d.login_data 
d.login_label 
d.outputs 
d.outputsTitle 
d.update_name 
d.update_value 
d.updatefile_button 
d.updatefile_file 
d.updatefile_name 
h.about_title 
h.controls 
h.update_title 
r.outputs:hover 


Clase 
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Tabla D.2 Valores de los parámetros CSS en el theme unvlbasic en el archivo style.css 


Tipo Clase Parámetro Valor 
a logo background url(img/logo.svg') 
background-color inherit 
height 30px 
left Opx 
position absolute 
top 0px 
width 209px 
section_name color +000000 
left Opx 
position relative 
body unvl background-color HfOfOf0 
font-family Arial, Helvetica, sans-serif 
font-size .Sem 
height 2000px 
overflow-x scroll 
overflow-y scroll 
text-align left 
unvl_admin background-color *ft0000 
font-family Arial, Helvetica, sans-serif 
font-size .Sem 
height 2000px 
overflow-x scroll 
overflow-y scroll 
text-align left 
admin_general background-color tede0e0 
border 1px solid 000000 
position absolute 
right 10px 
top 10px 
width 981px 
div admin logout background-color transparent 
border Opx solid ++000000 
height 25px 
left 10px 
position absolute 
text-align center 
top 320px 
width 209px 
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PARÁMETROS DEL TEMA unvlbasic 


Tipo Clase Parámetro Valor 
admin_modelfiles background-color transparent 
border Opx solid ++000000 
left 10px 
position absolute 
top 350px 
width 209px 
anim2d background-color inherit 
border solid Opx ++000000 
margin-right auto 
position relative 
right 10px 
top 0px 
animation background-color inherit 
border solid 1px ++000000 
width 300px 
animationTitle float center 
font-weight bold 
position relative 
text-align center 
div body background-color *cOcOff 
border 1px solid 000000 
color inherit 
float center 
height 100% 
margin-left auto 
margin-right auto 
padding 10px 
position relative 
width 900px 
body_admin background-color 4117777 
border 1px solid 000000 
color inherit 
float center 
height 100% 
margin-left auto 
margin-right auto 
padding 10px 
position relative 
width 1200px 
controls background-color tffaaaaaa 
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Tipo Clase Parámetro Valor 
border solid 1px ++000000 
left 10px 
margin-left auto 
controls margin-right auto 
position absolute 
top 320px 
width 209px 
controlsEmbed background-color tffaaaaaa 
border solid 1px ++000000 
left 10px 
margin-left auto 
margin-right auto 
position absolute 
top 50px 
width 209px 
controls_buttons text-align center 
div controls_change height 30px 
position relative 
top 0px 
width 90px 
controls_change_minus background-image urlCimg/menos.gif”) 
height 10px 
left Opx 
position absolute 
top 12px 
width 20px 
controls_change_plus background-image url(Cimg/mas. gif”) 
height 10px 
left Opx 
position absolute 
top 2px 
width 20px 
credits background urlCimg/info.gif”) 
height 30px 
position absolute 
right Opx 
width 30px 
documentation background-color HEEE 
border 1px solid 000000 
color inherit 
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PARÁMETROS DEL TEMA unvlbasic 


Tipo Clase Parámetro Valor 
display table 
height 260px 
padding Opx 
position absolute 
right 10px 
top 50px 
width 680px 

documentationEmbed background-color HEEE 
border 1px solid 000000 
color inherit 
height 260px 
padding Opx 
position absolute 
right 10px 
top 50px 
width 900px 

downdata margin-top 10px 
text-align center 

div logo background-color inherit 
height 30px 
left 10px 
position absolute 
top 10px 
width 209px 

menu background-color AEREA, 
border solid 1px ++000000 
font-size 1.1em 
height 260px 
left 10px 
overflow-x scroll 
overflow-y scroll 
position absolute 
top 50px 
width 209px 
messagenomodel background-color iii 
display table-cell 
font-family Arial, Helvetica, sans-serif 
font-size 2em 
text-align center 
vertical-align middle 
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Tipo Clase Parámetro Valor 
outputs color inherit 
height 220px 
margin 0px 
padding Opx 
position absolute 
right 10px 
top 320px 
width 682px 
outputsEmbed color inherit 
height 220px 
margin 0px 
padding Opx 
position absolute 
right 10px 
top 50px 
width 682px 
div plots background-color inherit 
border solid Opx ++000000 
left 10px 
margin-left 10px 
margin-right auto 
position relative 
top 0px 
section_name color +000000 
left 10px 
position relative 
tables background-color inherit 
border solid Opx ++000000 
height 220px 
left 10px 
margin-left 10px 
margin-right auto 
overflow auto 
position relative 
text-align center 
top 0px 
width 302px 
title background-color inherit 
font-size 2em 
height 30px 
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PARÁMETROS DEL TEMA unvlbasic 


Tipo Clase Parámetro Valor 
left Opx 
overflow-x auto 
overflow-y auto 
position absolute 
text-align center 
width 651px 

title_frame background-color *He0e0e0 
border 1px solid 000000 
height 30px 
position absolute 
right 10px 
top 10px 
width 681px 
wellcome font-size 3em 

div wellcome_box background-color HFOO 
border solid 4px ++000000 
color *+0000FF 
float center 
margin-left auto 
margin-right auto 
padding 20px 
position relative 
text-align center 
top 150px 
width 350px 

wellcome_buttons background-color *inherit 
color 4000000 
float center 
margin-left auto 
margin-right auto 
padding 10px 
position relative 
text-align center 
top 150px 
width 350px 
wellcome_explain font-size 0.8em 
wellcome_sub font-size 2em 
input checkUpdate width 40px 
color width 70px 
controls height 20px 
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Tipo Clase Parámetro Valor 
width 100 % 
controls_button background-color *dddddd 
border solid 1px ++000000 
font-size 0.8em 
height 25px 
padding Opx 
width 70px 
controls_button_file text-align center 
width 50px 
downdata background-color ++dddddd 
border solid 1px ++000000 
font-size 0.8em 
height 25px 
padding Opx 
width 100px 
input login 
logout_button background-color *+dddddd 
border solid 1px ++000000 
color 2000000 
float center 
font-size 1.0em 
height 25px 
margin-left auto 
margin-right auto 
position relative 
width 150px 
mediumUpdate width 100px 
miniUpdate width 50px 
normalUpdate width 300px 
wellcome_button background-color *+dddddd 
border solid 1px ++000000 
color 4000000 
float center 
font-size 1.0em 
height 25px 
margin-left auto 
margin-right auto 
position relative 
width 150px 
object documentation height 100 % 
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Tipo Clase Parámetro Valor 
width 100 % 
rect control_back fl none 
stroke none 
control_bar fl *ft0000 
stroke none 
select controls background-color AENA 
width 100 % 
miniUpdate text-align center 
width 100px 
normalUpdate width 300px 
svg controls height 8px 
width 100 % 
about border-collapse collapse 
font-size .Sem 
text-align left 
controls color *0000ff 
font-size 1.0em 
table outputs border solid 1px ++000000 
border-collapse collapse 
color 4000000 
float center 
font-size 0.8em 
margin-bottom 10px 
margin-left auto 
margin-right auto 
margin-top 10px 
update border-collapse collapse 
font-size .8em 
margin-left auto 
margin-right auto 
margin-top 10px 
text-align left 
updatefile background-color HFFEEEE 


border 


solid 1px ++000000 


border-collapse 


collapse 


font-size .Sem 
margin-left auto 
margin-right auto 
margin-top 10px 
text-align left 
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Tipo Clase Parámetro Valor 
width 200px 
about_name background-color *FFCCCC 
border solid 1px ++000000 
color 4000000 
width 150px 
about_value background-color ÁFFEEEE 
border solid 1px ++000000 
color 13333FF 
width 300px 
about_video background-color ÁFFEEEE 
border solid 1px ++000000 
color 13333FF 
text-align center 
width 60px 
controls color 4000000 
text-align left 
width 100px 
login_button text-align center 
td login_data text-align left 
login_label text-align right 
outputs border solid 1px ++000000 
text-align center 
width 40px 
outputsTitle border solid 1px ++000000 
font-weight bold 
text-align center 
width 40px 
update_name background-color RFECCCC 
border solid 1px ++000000 
color 4000000 
width 150px 
update_value background-color HFEFEEEE 
border solid 1px ++000000 
color 13333FF 
width 300px 
updatefile_button width 55px 
updatefile_file width 30px 
updatefile_name width 120px 
textarea normalUpdate height 100px 
width 300px 
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Tipo Clase Parámetro Valor 
about_title background-color RFFCCCC 
border solid 1px ++000000 
color 4000000 
font-size 1.0em 
text-align center 
th controls color +*0000ff 
text-align left 
width 200px 
update_title background-color RFECCCC 
border solid 1px ++000000 
color 4000000 
font-size 1.0em 
text-align center 
width 150px 
tr outputs:hover background-color ++88DDDD 


Tabla D.3 Clases y parámetros CSS personalizados en el theme unvlbasic en el archivo styleSVG.css 
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line.grid x |x| x 
path.curve x x 
rect.frame x x x 
rect.plot x x x 
rect.tag x Xx Xx 
svg.plot x x x |x| x x 
text.legend x x 
text.tagH Xx | Xx x 
text.tagV X | x x 
text.title x x 
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Tabla D.4 Valores de los parámetros CSS en el theme unvlbasic en el archivo styleSVG.css 


Tipo Clase Parámetro Valor 
line grid stroke 1333333 
stroke-dasharray 33 
stroke-width 1px 
path curve fill none 
stroke-width 1px 
rect frame fill tfeeecee 
stroke 000000 
stroke-width 2px 
plot fill HERE 
stroke 000000 
stroke-width 2px 
tag fill HAEREr 
stroke none 
stroke-width 1px 
svg plot background-color inherit 
font-family arial, times, serif 
font-style normal 
font-weight normal 
height 200px 
width 300px 
text legend dominant-baseline middle 
font-size 10pt 
tagH dominant-baseline auto 
fill 4888888 
font-size 10pt 
tagV dominant-baseline middle 
fill 4888888 
font-size 10pt 
title fill 4555555 
font-size 14pt 
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VERSIÓN 1.0 


Como parte del proceso de desarrollo natural de UNVirtualLab se implemen- 
tó una versión previa (Versión 1.0, presentada en [Dua11]) que sirvió como 
prueba conceptual de la herramienta. La versión actual, la 2.0, conserva mu- 
chos de los elementos de esa primera versión, pero se diferencia en algunos 
aspectos importantes de diseño: 


La versión 1.0 no utilizaba ninguna base de datos. En su lugar, la infor- 
mación necesaria se almacenaba en archivos de texto en formato XML. 


Los gráficos de la versión 1.0 se preparaban en el lado del servidor en 
formato png. La versión 2.0 genera los gráficos en formato svg que son 
construidos por el navegador (lado del cliente). 


Las animaciones de la versión 2.0 también se preparaban en formato png 
animado. La versión 2.0 lo hace en formato svg. 


La versión 1.0 incluía la opción de construir animaciones 3D a partir de 
primitivas gráficas. Esta funcionalidad se ha omitido en la versión 2.0, a 
la espera de un mayor desarrollo de las opciones 3D del formato svg. 


La versión 1.0 utilizaba los archivos de resultados de los ejecutables en 
formato p1t (el único disponible en ese entonces). La versión 2.0 lo hace 
en formato csv. 
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Los efectos más notorios de estos cambios han sido: 


= La modularidad del código fuente se ha incrementado. 


La mantenibilidad del código fuente se ha mejorado. 


Los tiempos de respuesta del servidor se han disminuido. 


La uniformidad de las gráficas se ha mejorado. 


La personalización de las implementaciones se ha incrementado. 
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O) 
“PROPIO 
NOTAS DE CLASE 


El libro presenta el diseño y desarrollo de 
UNVirtualLab, un ambiente web para alojar 
laboratorios virtuales de simulación de fenómenos 
dinámicos. En él se explica qué es UNVirtualLab, 
para qué puede utilizarse, cómo está diseñado, 

cómo se utiliza y cuáles son los fundamentos que le 
subyacen. El libro está conformado por tres partes 

y 14 capítulos; en la primera parte se explican los 
principios teóricos - matemáticos y de software - 
aplicados en la construcción de modelos orientados 
a objetos y su ulterior simulación en la suite 
OpenModelica; los capítulos que la componen se han 
redactado a manera de texto guía, y pueden ser 
utilizados en un módulo de algún curso de posgrado 
dedicado al modelado orientado a objetos. 

La segunda parte presenta en detalle las 
características del laboratorio virtual UNVirtualLab 
y en la tercera parte se ilustra su potencial con un 
conjunto de casos de ejemplo. 


